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rights or legally protectible rights may be used instead of the IBM product, program, or service. Evaluation 
and verification of operation in conjunction with other products, programs, or services, except those expressly 
designated by IBM, are the user’s responsibility. 


IBM may have patents or pending patent applications covering subject matter in this document. The 
furnishing of this document does not give you any license to these patents. You can send license inquiries, in 
writing, to the IBM Director of Commercial Relations, IBM Corporation, Purchase, N.Y. 10577. 


The following terms, denoted by an asterisk (*) in this publication, are trademarks of the IBM Corporation 
in the United States and/or other countries: 


IBM 

MVS/ESA 

MVS/SP 

MVS/XA 

Processor Resource/Systems Manager 
PR/SM 

System/370 

Virtual Machine/Extended Architecture 
VM 
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Preface 


Purpose 


This manual describes how to: 


° Install the Virtual Machine/Extended Architecture System Product (VM/XA SP) on a 370-XA 
processor 


e Apply corrective and preventive service to the VM/XA System Product Release 2.1. 


This manual is intended to help you install and service VM|XA System Product Release 2.1. It primarily 
contains installation and service information. The information in this manual must not be used for 
programming purposes. 


Superseded Information 


This edition contains information from, and supersedes, the following documents: 
e VM[XA SP Installation and Service, SC23-0364-2 
¢ VM/XA SP Serviceability Enhancements Program Update Information APAR VM37518, GC23-0503-0 
¢ VM/XA SP Release 2.1 Installation and Service Technical Newsletter, SN31-1592 
e VM Program Update Information Enhancements for Receiving Electronic Service, GC24-0533-0 
© The “Installation and Service” chapter of VM/XA SP 2.1 Release Guide, GC23-0510-0. 


Prerequisite APARs 


The following APARs are prerequisites to this edition: 
VM39596 
VM40518 
VM40833 
VM41018 
VM41040 
VM41097 
VM41159. 


Audience 


This publication is intended for those people responsible for installing and applying service to the VM/XA 
System Product Release 2.1. 
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Prerequisite Knowledge 


To get the most out of this book, you should have a general idea of what the VM/XA System Product 
Release 2.1 does and what a virtual machine is. You should also have a general understanding of System/370 
and 370-XA data processing techniques. 


How to Use This Publication 


Whenever you need to perform a system task, this publication describes the task in one- and two-column 
format. 


1. Substeps in any task will be numbered and appear in one-column format, just like the lines you are now 


XVi 


reading. 


Screen output and input will appear on the left side 
of a two-column format. An example of screen 
output 1s a system message: 


DMSACC724I '195' REPLACES 
‘A (191) ' 


Screen output may appear in all capital letters or 
in mixed-case. Variable information is always in 
italic small letters. For instance: 


REPLY value TO THE PROMPT 
"CYL|BLK ADDRESS" 


Input that you must enter appears on the left side 
of the two-column format in blue lowercase bold 
letters. The square bullet (#) next to input lines 
indicates you must press the ENTER key on the 
display console. For instance: 


access 191 a Hf 


Sometimes input you must enter varies. In such 
cases, italicized variables will appear. For 
instance: 


input rdevno devtype xasres 


Information about screen output and input appear 
on the right side of a two-column format. For 
example: 


This message tells you that minidisk 195 1s now 
the A-disk. The indentation of the second line 
indicates that this message appears all on one line 
on the display terminal. 


If screen output or input contains variable 
information, the information is explained on the 
right side. For example: 


value is a cylinder/block address; it may be the 
number 68, 105, or 66. 


The right side of the two-column format will also 
explain input that you must enter. For instance: 


Issue this command to make your 191 minidisk 
the A-disk. 


When the input you enter is variable, notes on the 
right side will explain the variable information. 
For example: 


The second control statement is the input control 
statement. Identify the device number -(rdevno) 
and the tape device type (devtype) where the 
Starter System Tape is mounted. 


Note: The output that is documented in this book may not exactly match what appears at the display 
terminal. However, important messages and prompts that are necessary to perform the system 
installation are included in the steps for installation. 
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Part | also uses figures to introduce an installation step and to aid you when you want to make quick 
references to installation steps. For example: 


This is an example of a system installation introductory figure. 
Use it to: 


¢ Introduce yourself to the system generation step 
¢ Provide a quick reference for the step. 


Figure 1. Example of System Installation Introductory Figure 


Some Common Abbreviations and Variables 


Here is a list of common abbreviations and variables used in this publication: 


Abbreviation Term 


rdevno Real device number 
vdevno Virtual device number 
devtype Device type 

volid Volume identification 


userid, user ID User identification for a virtual machine 


fn Filename 

ft | Filetype 

fm Filemode 

V=F Virtual = Fixed 
V=R Virtual = Real 
V=V Virtual = Virtual 


Related Publications 


If you want to know the order number of a publication this book refers to, see “VM/XA System Product 
Publications” on page 909. This section also lists other hardware and software books that may help you 
perform virtual machine operation tasks. 


You can find the titles of all VM/XA System Product Release 2.1 publications in Figure 69 on page 910. 
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Part 1. Installing the System 


Part 1 of this book contains the following chapters: 


e Chapter 1, “Introduction” on page 3, describes the starter system, the MAINT virtual machine, the 
difference between first level and second level installation, and planning considerations for installing the 
Group Control System (GCS) and for installing a new system national language. 


¢ Chapter 2, “Installing VM/XA System Product Release 2.1 with the Starter System (First Level)” on 
page 13, shows the process of installing VM/XA System Product Release 2.1 with the starter system at 
first level. 


e Chapter 3, “Installing VM/XA System Product Release 2.1 with the Starter System (Second Level)” on 
page 113, shows the process of installing VM/XA System Product Release 2.1 with the starter system at 
second level. 


e Chapter 4, “Installing VM/XA System Product Release 2.1 Using an Existing VM/SP or VM/SP HPO 
System” on page 215, shows the process of installing VM/XA System Product Release 2.1 using an 
existing VM/SP or VM/SP HPO system. 


¢ Chapter 5, “Installing a New System National Language” on page 311, shows how to install a new 
default system national language. 
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Part | describes the step-by-step installation procedures for the control program (CP), conversational monitor 
system (CMS), dump viewing facility (DV), and group control system (GCS). 


In Chapter 2, “Installing VM/XA System Product Release 2.1 with the Starter System (First Level),” and 
Chapter 3, “Installing VM/XA System Product Release 2.1 with the Starter System (Second Level),” the 
installation steps require you to use a Virtual Machine/Extended Architecture* System Product (VM/XA* 
SP) starter system. The starter system is a functional VM/XA System Product system that you can use to 
tailor VM/XA System Product to your processor configuration. The starter system contains a full-screen 
editor that aids in creating and modifying system definition files—the system control file (HCPSYS 
ASSEMBLE), the real I/O configuration file (HCPRIO ASSEMBLE), the user directory (USER DIRECT), 
and the CMS generation file (DMSNGP ASSEMBLE). 


To use the starter system, you must: 
e Restore the system from the starter system tape that IBM* supplies 


¢ Perform a hardware initial program load (IPL) from the system residence device CXASRES). 


The starter system tape contains the DASD DUMP/RESTORE (DDRXA) program in the first file. 
DDRXA is a stand-alone program that restores the starter system from tape to the system residence device. 
Also included in the first file is the Device Support Facilities program; during installation, this program 
inspects DASD volumes being used for minidisks. 


The starter system tape contains the VM/XA System Product starter system as the second file. The starter 
system is device dependent; that is, you must restore the system to its compatible device type. IBM supplies 
3350, 3375, 3380, and 3390 starter systems. 


Figure 2 shows the file arrangement of the starter system tape. 


Device 
Support DASD Dump 


Facilities Restore (DDR) Starter ISD Trailer 
Program Program System Files 


File 1 File 2 File 3 


Figure 2, Starter System Tape 
After you have installed the starter system, you have a vehicle to continue the VM/XA System Product 
installation. Now you must: 

e Load onto disk the VM/XA System Product product tape that IBM supplies. 


Note: As soon as the CMS part of the product tape is loaded by the ITASK EXEC, CMS will be 
generated with IBM-supplied defaults. Later you can regenerate the CMS nucleus with your own 
defaults. 


Figure 3 shows the file arrangement of the product tape. 


Virtual Machine/Extended Architecture, VM/XA and IBM are trademarks of the IBM Corporation. 
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File 1 =" 2 + 3 \File 4 


Figure 3. VM/XA SP Product Tape 


Notes: 
1. The term product tape refers to the whole set of three tape volumes. 


2. The product tape is in VMSUP format. This means that PUT and COR service are shipped with the 
base product and are applied when you install the system. 


3. The file arrangement has not changed for VM/XA System Product Release 2.1. Corrective service 
files, however, are now in the PUT apply and PUT delta tape files. The corrective apply and 
corrective delta files are dummies. 


e Install Assembler H Version 2 Program Product. 


e Edit IBM-supplied sample of CMS generation file DMSNGP ASSEMBLE) then edit the IBM-supplied 
samples of the system control file CHCPSYS ASSEMBLE) and the real I/O configuration file (HCPRIO 
ASSEMBLE) or create your own system control and real I/O configuration files. 


e Generate the conversational monitor system (CMS) and the control program (CP) components of 
VM/XA System Product. 


Note: You do not need to generate the dump viewing facility. 


e Perform a hardware initial program load of the newly generated VM/XA System Product. IBM 
generates the dump viewing facility for you and it is loaded onto DASD from the product tape. 


¢ Update the user directory (USER DIRECT). 
e Install the Environmental Record and Editing Program. 
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e Make CMS into saved systems—a 370 system and a 370/XA system. 
¢ Install the group control system. 
¢ Create the CMSDOS, CMSBAM, CMSVSAM, CMSAMS, CMSINST, and HELP saved segments. 


Special EXECs (ITASK EXEC, SPLOAD EXEC, and VMFBLD EXEC) do much of the system generation 
process. The EXECs operate interactively—this publication explains necessary responses and decisions you 
must make during the installation procedure. 


The SPLOAD EXEC formats minidisks and loads product tape files to those minidisks. 


The VMFBLD EXEC creates the CP, CMS, and GCS nuclei. 
Note: In this publication, the term system nucleus means: 
¢ A system that is resident in main storage, 
OR 


¢ A loadable system that is resident on the system residence device. 


MAINT Virtual Machine 


Key to the system generation procedure is a virtual machine called MAINT. The MAINT virtual machine 
has a special minidisk configuration and an important set of command privilege classes; the minidisks and 

command classes allow MAINT to generate the VM/XA System Product system. Few virtual machines in 
the VM/XA System Product system have the same capabilities to alter the system. 


The starter system has a user directory that defines the MAINT virtual machine for you. After you have 
initialized the starter system, you will use MAINT and continue with the system generation procedure. 


Part of the generation procedure is loading the product tape. You will notice from screen messages that the 
product tape loads onto several of MAINT’s minidisks. The reason for separating parts of the product tape 
onto several minidisks is that this strategy keeps the VM/XA System Product components separate; the 
strategy also separates source files and object files. The separations are important not only to the system 
generation procedure but also to IBM service. (For more information about IBM service, see Part 2, 
“Servicing the System” on page 347.) 


If you want more information about the MAINT virtual machine, see “The MAINT Virtual Machine” on 
page 352. 


System Installation on 308x, 4381, and 3080 Processor Complexes 


On 308x, 4381, and 3090* Processor Complexes, the hardware requires its own I/O configuration data. Such 
data resides in input/output configuration data sets (OCDS) in the processor controller. The processor 
controller can hold more than one IOCDS, allowing an installation to vary the I/O configuration according 
to the IOCDS. At system initial microprogram load (IML), the system operator chooses one IOCDS to 
define the I/O configuration. 


Using the Input/Output Configuration Program, you can create a new IOCDS. VM/XA System Product 
requires its own definition of an I/O configuration. Such a definition comes from macro instructions 


3090 is a trademark of the IBM Corporation. 
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contained in a file called HCPRIO ASSEMBLE. Be sure to make information in the HCPRIO ASSEMBLE 
file compatible with information in the IOCDS. 


At system initialization, CP sends warning messages to the primary system operator about devices it finds 
offline. CP does this by checking the hardware I/O configuration defined by the IOCDS. If you have made 
sure that HCPRIO ASSEMBLE and the IOCDS are compatible, the primary system operator will receive 
warning messages only for devices that are intended to be online but were inadvertently left offline. System 
initialization procedures will therefore be less error prone. 


If your computer center has more than one 308x, 4381, or 3090 Processor Complex on which VM/XA System 
Product may run, IBM advises you to create on each processor complex one IOCDS that is compatible with 
VM/XA System Product. Then you are always assured of having an I/O configuration compatible with 
VM/XA System Product. 


For more information, see the Input/Output Configuration Program User's Guide and Reference for 308x 
concerns, the JBM 4381 Input/Output Configuration Program User's Guide and Reference for 4381 concerns, 
and the 3090 Input/Output Configuration Program User's Guide and Reference for 3090 concerns. 


VM/XA System Product Starter System 


The starter system defines the following devices automatically: 
¢ The primary system operator’s console 
e One DASD from which you will load (IPL) the VM/XA System Product starter system. 


Warning: Do not use your current system residence device. You will need it if for some reason you have 
to return to your current system. 


The VM/XA System Product starter system allows you to define the other devices necessary for system 
generation (see Appendix C, “VM/XA System Product Starter System Information” on page 725). These 
devices are: 


e The primary system operator’s alternate console (optional, but recommended). 
e One card reader and punch (not required). 

¢ Two tape drives (the second tape drive is optional, but recommended). 

e One printer. 


¢ A DASD volume for use as a work pack. The work pack is required if you are using 3350 or 3375 
DASD, or a single-density 3380 or 3390 DASD. 


Note: This volume must be the same device type and model as the system residence volume. 
e A second work pack. The second work pack is required if you are using 3350 or 3375 DASD. 
Note: This volume must be the same device type and model as the system residence volume. 


e A third work pack (with the system residence volume, there will be a total of four DASD volumes). The 
third work pack is required for the 3350 starter system. It is not available for the 3375, 3380, and 3390 
Starter systems. 


Note: This volume must be the same device type and model as the system residence volume. 
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Password Security 


After you define the starter system configuration, you invoke the ITASK EXEC, which formats minidisks 
and loads files from the product tape. The first thing the EXEC does is to ask you for a password for 
MAINT and OPERATOR. You must supply a temporary password for MAINT and OPERATOR to log on 
and off the starter system. Table 1 on page 7 has a place for you to write in the temporary password—do so 
only if you take appropriate security measures, since the password allows access to the starter system. 


A later step in the installation procedure tells you to update the user directory of your new system. Be sure 
to change all the passwords, including the passwords for MAINT and OPERATOR, to non-restricted 
passwords. (For the IBM-supplied list of restricted passwords, see Appendix F, “Restricted Logon 
Passwords” on page 859.) 


Starter System Worksheet 


Complete Table 1 before you begin the VM/XA System Product installation procedure. This table is 
designed to aid you throughout the installation procedure. 


Table 1. Starter System Worksheet 


Devices automatically defined by Write the device number (rdevno) | Circle the device type you will 
the starter system of the devices use for the installation procedure 


Primary system console 3277, 3278, 3279 


3350, 3375, 3380, 3390 
Write the device number (rdevno) | Circle the device type you will 
of the devices you are defining use for the installation procedure 
1 


1403, 3203, 3211, 3262, 3800- 
(see Note), 3800-3, 4245, 4248 


2540P, 3525 
2501, 2540, 3505 
3420, 3422, 3430, 3480 


3420, 3422, 3430, 3480 


3350, 3375, 3380, 3390 


Starter system IPL volume 
(XASRES) | 


Devices you can define using the 
starter system 


Printer 


Punch device (optional) 
Card reader device (optional) 
First tape drive 


Second tape drive 
(recommended) 


Work pack (XASERV; required 
for all DASD except 3380-E4, 
3380-K, and 3390) 


Second work pack (XAP001; 
required for 3350 and 3375 
DASD) 


Third work pack (XAP002; 
required for 3350 DASD, not 
available for other DASD) 


Display device—alternate system 
console (optional) 


Password for MAINT and 
OPERATOR 


Note: 3800 defaults to the 3800 Model 1. 


3350, 3375, 3380, 3390 


3350 
3277, 3278, 3279 


Not applicable 
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Warning: The ITASK EXEC cannot handle virtual DASD that are defined with different physical 
characteristics from the real DASD. Consider this restriction when you define the virtual DASD used in the 
installation procedure. For example, do not define a real double-density 3380 as two virtual single-density 
3380s. 


First-Level and Second-Level Installation 


The virtual machine concept of VM allows you to install VM/XA SP as the operating system of a real 
machine or as the operating system of a virtual machine. 


Installation of VM/XA SP as the operating system of a real machine is called first-level installation. At first 
level, you use the system operator’s console to control system functions. 


The operating system usually run in a VM/XA SP virtual machine is CMS. However, other operating 
systems that can run in a virtual machine include VSE/SP, MVS/SP*, MVS/XA*, MVS/ESA*, VM/SP, 
VM/SP HPO, VM/XA SF, and VM/XA SP. Installation of VM/XA SP as the operating system of a virtual 
machine is called second-level installation. At second level, your “console” is a terminal logged on to the 
first-level VM system through a valid user ID. 


When you do a first-level installation, you must have access to the real machine. You mount and ready the 
required DASD volumes and tapes, perform system IPLs (initial program loads), and display PSWs (program 
status words). This book assumes that you already know how to operate the computer and all of its 
associated hardware devices; no assistance is provided for these tasks. 


When you do a second-level installation, you may have access only to your own virtual machine. Someone 
else, such as the computer operator, may have to mount and ready your DASD and tape volumes and attach 
them to your first-level user ID. 


Note: You can install VM/XA System Product at second level only if your first-level VM/XA system has at 
least 16 megabytes of storage. 


Perhaps the most important difference between first-level and second-level installation concerns system 
addresses. At first level, when you IPL your system residence volume, you IPL the real address of the 
DASD. When you IPL your system residence volume at second level, you IPL the virtual address of a 
minidisk (or DASD) attached to your first-level user ID. This first-level minidisk (which may be a full-pack 
minidisk) functions as a “real” DASD volume at second level. 


At second level, it is also important to keep in mind that you can communicate with two levels of CP. 
First-level CP provides the virtual machine in which you are installing the VM/XA SP system that contains 
your second-level CP. At times when you are running at second level, you may want to issue commands to 
first-level CP. You can do this by first pressing PA1. 


Because second-level users can issue commands to first-level CP, it is wise to limit the authority of the virtual 
machine that installs a second-level system. Specifically, this virtual machine should not have Class A 
authority so that it cannot shut down the first-level system. 


MVS/SP, MVS/XA, and MVS/ESA are trademarks of the IBM Corporation. 
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_ Figure 4 shows the relationship between first-level and second-level operation. 


CMS running 
in virtual 
machine ‘Z' 


Second level CP 
running in 
virtual machine ‘Y' 


CMS running 
in virtual : 
machine 'X' 


First Level CP 


Hardware 


Figure 4. Relationship Between First-Level and Second-Level Operation 


Planning for the Group Control System (GCS) 


If you plan to install SNA (Systems Network Architecture) products or RSCS (Remote Spooling 
Communications Subsystem) Version 2, you must install the GCS component. 


GCS is a named saved system that can be IPLed by a “group” of one or more virtual machines. GCS 
provides a variety of services to the group, such as supporting a native VM/SNA network that functions as 
part of your VM/XA SP system without help from a guest operating system. 


For more information about GCS concepts and facilities, refer to the VM/XA SP Group Control System 
Command and Macro Reference, VM/XA SP Features Summary, and VM/XA SP Planning and 
Administration. 


If you plan to install GCS, you must define the GCS saved system and the virtual machine group. A sample 
GCS saved system is already defined for you in the SAMPNSS EXEC, but you may want to tailor it to meet 
your own requirements. To define the virtual machine group, you invoke the GROUP EXEC to create a 
group configuration file. 


You can install more than one GCS system on your VM/XA SP system. Planning for each GCS system 
involves the following operations: 


¢ Calculating your GCS storage requirements 


You need to talculate how much private storage and common storage your GCS system requires. You 
use these figures during the installation procedure when you: 


— Tailor the GCS entry in the system directory 
— Change the GCS entry in the SAMPNSS EXEC 
~ Create the GCS configuration file 


VM/XA SP Planning and Administration provides a procedure that you can use to calculate your storage 
requirements. 


¢ Planning the GCS entry in the system directory 


The sample directory (USER DIRECT) supplied on the VM/XA SP product tape contains an entry for a 
GCS recovery machine (user ID GCS). Before you can use GCS, you must modify this entry to remove 
NOLOG from the USER statement and substitute a valid logon password. You may also have to 
change the machine size if you calculated a greater storage requirement. 
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In addition, if you have defined your GCS named saved system as restricted, you must add a 
NAMESAVE statement to the directory of each system allowed to use GCS. 


VM/XA SP Planning and Administration explains the structure of system directory entries. 
¢ Planning the GCS entry in the SAMPNSS EXEC 


When you have calculated your storage requirements for GCS, you can plan the GCS entry in the 
SAMPNSS EXEC. As supplied on the product tape, the SAMPNSS EXEC contains a sample DEFSYS 
entry for GCS. During the installation procedure, you can tailor this entry to define your GCS system. 


The SYSNAME that you specify in this entry (the supplied name is GCS) must be the same “system 
name” that you specify when you create the GCS configuration file. 


If you plan to install multiple GCS systems, you must create a new DEFSYS entry for each additional 
system and select a unique SYSNAME for each one. 


VM/XA SP Planning and Administration shows a sample DEFSYS entry. 
¢ Planning the GCS configuration file. 


You create the GCS configuration file during the installation procedure by invoking GROUP EXEC, 
which presents a series of panels (screens) that ask you to supply certain information about your GCS 
system. You may find it helpful to record this information now in your Installation Reference Worksheet 
(space is provided to define up to three GCS systems). 


Note: If you do not have a full screen display device, you cannot use GROUP EXEC, because you 
cannot display the panels. In that case, you must build the configuration file manually during the 
installation procedure using the build macros described in the VM/XA SP Group Control System 
Command and Macro Reference. You may want to look at that book now to become familiar 
with the operation of those macros. 


System Name | This is the name of your GCS saved system. You must select a unique 
name for each GCS system that you want to install. GROUP EXEC creates 
a configuration file named systemname GROUP, which becomes the 
blueprint for your virtual machine group. 


Authorized Userids These are the user IDs allowed to run in supervisor state and allowed to use 
GCS functions. For example, these user IDs have authorization to change 
common storage. Make sure that these user IDs have an appropriate 
privilege class specified in their directory entries. 


System Disk Address This is the virtual address of the GCS system disk. MAINT 595 is the 
default, as defined in SPLOAD PROFILE and in the system directory. 


System Disk Ext. Address This is the virtual address of the GCS system disk extension. MAINT 59E 
is the default, as defined in the system directory. This disk is available for 
use by applications. | 


Common Dump Receiver Normally, when a user ID’s virtual storage is dumped to trace a problem, 
the dump file is spooled to the user ID’s virtual reader. However, when you 
create the configuration file, you can select one authorized user ID to receive 
all GCS virtual storage dumps. If one of your GCS user IDs is the RSCS 
virtual machine, you must name a common dump receiver, since the RSCS 
virtual machine cannot process a dump file spooled to its own virtual reader. 


Recovery Machine You must specify one authorized user ID to act as the recovery machine. 
The sample directory defines a recovery machine called GCS. (You may 
give it a different name.) The recovery machine must be the first machine to 
join your group, and ts responsible for cleaning up system resources when 
other machines using those resources reset. 
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Trace Table Size This table contains a history of GCS supervisor events. 16K is the default 
size. However, increasing the number of applications that you run also 
increases the activity of the GCS supervisor, which may require a larger 
trace table. 


Max. Virtual Machines This is the maximum number of virtual machines allowed in the group at 
one time. The number that you select depends upon how much space you 
have available in common storage. 


System ID This is the message that is displayed at the console of a virtual machine 
operator who IPLs this GCS segment. You can define up to 130 characters. 


Saved Segments These are the other saved segments (such as VTAM) that you want to 
access. They are linked automatically when you IPL your GCS system. 
Before you provide this information, you must find out what requirements 
these segments have. 


Note: Do not include CMSVSAM and CMSBAM segments here. Instead, 
follow the procedures described in Chapter 2, “Installing VM/XA 
System Product Release 2.1 with the Starter System (First Level)” or 
Chapter 3, “Installing VM/XA System Product Release 2.1 with the 
Starter System (Second Level)” to build these segments as part of 
your base installation. 


installing National Languages On Your VM/XA System Product 
Release 2.1 System 


VM/XA System Product Release 2.1 is shipped with mixed-case American English as the system national - 
language. This language is automatically set for CP and all virtual machines on the system. When users log 
on, they receive messages, see panels and HELP files, and enter CP and CMS commands in mixed-case 
American English. 


At installation time, you can change the system default from mixed-case American English to uppercase 
American English. 


You can also order other national languages to install on your system. National languages are distributed on 
language feature tapes. The files on a language feature tape contain translated information. 
There are two ways to install a national language: 


e As the new default system national language (replacing mixed-case American English or uppercase 
American English). 


Then, when users log on, they receive most messages, see some panels, and see some CP and CMS HELP 
files in the new language. 


In this type of language installation, the language files are used to create new system nuclei. The 
procedure is a supplement to the base installation procedure, and is described in Chapter 5, “Installing a 
New System National Language” on page 311. 


Notes: 


1. The extent of the translated information may vary between national languages, and some messages, 
panels, and HELP files may still appear in American English. 


2. The language of the installation and system generation tools is American English, and cannot be 
changed. 
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¢ As an option available to system users to supplement or override the system national language. 


You can install several national languages (including mixed-case American English and uppercase 
American English) in this manner, and you can set the languages that are available for individual users. 
This type of language installation must be performed after your base system is installed. 


For more information, see VM4/XA SP Planning and Administration. 


Some Notes Before You Begin 


Before you begin system generation, there are a number of things you must do. These things are: 


¢ Check to see if you have the minimum hardware configuration required to generate VM/XA System 
Product. See Appendix C, “VM/XA System Product Starter System Information” on page 725. 


¢ Use the Device Support Facilities to prepare DASD volumes. 


¢ Refer to the VM/XA System Product: Program Directory for the latest information affecting VM/XA 
System Product. 


e Be sure that you have the proper processor engineering change level for your processor. Consult your 
IBM representative to find out what it is. 


¢ Make sure that you have no DASD volumes with the same labels as the installation work volumes 
(XASERV, XAP001, and XAP002). If you do, relabel them so that the starter system does not attach 
them to the system. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in any 
one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


Some Notes on the Installation Procedure 


¢ Each installation process is divided into steps. In the event of a failure or termination for any reason, 
you can pick up the installation at the step immediately following the last successful step. 


¢ The dialogs in the installation procedures are samples. Depending on your system configuration, the 
prompts and messages you see on your screen may not exactly match those in the book. 
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Chapter 2. Installing VM/XA System Product Release 2.1 with 
the Starter System (First Level) 


Step 1. Load the Device Support Facilities 


In this step, you will load the Device Support Facilities (DSF) and use it to initialize and inspect the 
DASD for defective tracks. For more information about the Device Support Facilities, see the Device 
Support Facilities User’s Guide and Reference, SC35-0033. 


This step takes approximately 20 to 40 minutes for each DASD volume you inspect, depending on the 
type of DASD. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


1. Before you begin, make sure that you have read the information preceding these steps in Chapter 1, 
“Introduction” on page 3. 


2. Ready the DASD volumes you plan to use. Follow the operation manual for your own hardware. 


If the packs you plan to use for your installation are not already ICK DSF-initialized, you must initialize 
them before proceeding. 


Warning: No volumes with labels XASERV, XAPO001, or XAP002 should be attached to your system. 
Any such volumes will be brought on line when you IPL the starter system in Step 3. If necessary, you 
can use the Device Support Facilities to relabel your packs. Issue REFORMAT UNIT (rdevno) 
VERIFY (oldlabel) VOLID(newlabel) when DSF prompts you with ENTER INPUT/COMMAND. 


Warning: The addresses of XASRES, XASERV (if used), XAPOO1 (if used), and XAPO02 (if used) must 
match the addresses in the HCPRIO ASSEMBLE file. If the addresses do not match, you will not be 
able to IPL your new system in Step 20. If your addresses are not defined in the sample HCPRIO 
ASSEMBLE file for your DASD type, you will have to tailor it in Step 17. 


3. Mount the starter system tape on a tape drive. 


4. IPL the tape drive. Follow the hardware IPL procedure specified for your processor. Refer to the 
proper hardware operation manuals for help. For instance, on the 3081 Processor Complex, refer to the 
IBM 3081 Processor Complex Operator's Guide for the System Console. 


ICKOQ5E DEFINE INPUT DEVICE, REPLY This message tells you that the Device Support 
'DDD,CUU' OR 'CONSOLE' Facilities are loaded and ready. You MUST use 
ENTER INPUT/COMMAND: the Device Support Facilities to format your 
console # XASRES volume unless it is already formatted. If 
ICKOO6E DEFINE OUTPUT DEVICE, REPLY XASRES is already formatted, go on to Step 2. 


'DDDD,CUU' OR 'CONSOLE' 

ENTER INPUT/COMMAND: 

console 

ICKDSF - SA DEVICE SUPPORT FACILITIES 9.0 TIME:hhs:am:ss 
mm/dd/yy PAGE 1 

ENTER INPUT/COMMAND: 
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init unit(rdevno) devtype(33xx) novfy val volid(volid) 


rdevno is the address of the DASD volume you 
want to inspect. 33x x is the device type: 3350, 
3375, 3380, or 3390. volid is the volume identifier, 
in this case, XASRES. 


This command requests medial initialization of the 
volume. For maximal or minimal initialization, 
see the Device Support Facilities User's Guide and 
Reference. 


TICKOO7001 DEVICE INFORMATION rdevno IS CURRENTLY AS FOLLOWS: 
PHYSICAL DEVICE = 33xx 
STORAGE CONTROLLER = xx 
STORAGE CONTROL DESCRIPTOR = xxxx 
DEVICE DESCRIPTOR = xx 
ICKOO3D REPLY U TO ALTER VOLUME rdevno CONTENTS, ELSE T 
ENTER INPUT /COMMAND 


u & The system takes 20 to 40 minutes to inspect and 
reformat the DASD volume. After the DASD 
ENTER INPUT /COMMAND: volume has been reformatted, you will get a series 


of ICK messages that describe the status of the 
device being formatted. 


. If you want to inspect or format any more DASD volumes, repeat the INIT UNIT command. 


Otherwise, go to Step 2. 


Installation and Service 


Step 2. Restore the VM/XA System Product Starter System to Disk 


In this step, you will use the DDRXA utility to restore the starter system to disk. 


This step takes approximately 15 minutes. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


1. IPL the tape or cartridge. Follow the hardware IPL procedure specified for your processor. Refer to the 
proper hardware operation manuals for help. For instance, on the 3081 Processor Complex, refer to the 
IBM 3081 Processor Complex Operator's Guide for the System Console. 


2. Establish an interactive dialog with DDRXA: 
Notes: 


a. When you run DDRXA on a real processor, and you have a nonconsole device at real device number 
0009 or OOIF, make sure the device is not operational. Otherwise, results are unpredictable. 
(DDRXA initially assumes that your console has device number 0009 or 001F). 


b. Also, to prevent inadvertent access to DDRXA, turn off all displays other than the one you will be 
using for DDRXA, so that no one will press the ENTER key on another display and interrupt 
DDRXA while it 1s waiting for input. 


As soon as you load it into storage, DDRXA begins executing and sends you the following initial 
prompt: 


VM/XA SYSTEM PRODUCT DASD DUMP/RESTORE PROGRAM If the initial prompt is not shown on the display 

ENTER CARD READER ADDRESS OR CONTROL STATEMENTS you are using for DDRXA, press the ENTER key. 

ENTER: This action creates the necessary interrupt for 
DDRXA to recognize your display and to begin 
execution. 


3. Answer the prompting messages from the DDRXA utility: 
Note: The device types for which the following steps are valid include 3350, 3375, 3380, and 3390. 


VM/XA SYSTEM PRODUCT DASD DUMP/RESTORE PROGRAM 
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS 


ENTER: 

sysprint cons This first control statement tells DDRXA that you 
ENTER: want program messages sent to your console. 
input rdevno devtype (skip 1 The second control statement is the input control 
ENTER: statement. Identify the device address (rdevno) 


and tape device type (3420, 3422, 3430, or 3480) 
where the starter system tape 1s mounted. The 
option skip 1 tells DDRXA to skip over the tape 
mark placed on the tape just before the starter 
system. 
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output rdevno devtype scratch 
ENTER: 


restore all 


HCPDDR725D SOURCE DASD DEVICE WAS (IS) LARGER 
THAN OUTPUT DEVICE 
DO YOU WISH TO CONTINUE? 
RESPOND YES OR NO: 
yes 


RESTORING XASRES 
DATA DUMPED mm/dd/yy 
AT hh.mm.ss GMT FROM XASRES 
RESTORED TO SCRATCH 
INPUT CYLINDER EXTENTS OUTPUT CYLINDER EXTENTS 
START STOP START STOP 
cccc CCCC cccc = Cc 


END OF RESTORE 
BYTES RESTORED nannnnnnnn 


ENTER: 
a 


END OF JOB 
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This control statement specifies the mounted 
device number to which you are restoring the 
system (XASRES). Specify the device number 
(rdevno) and device type (devtype). Valid devtype 
values are: 


3350 
3375 
3380 
3390 


The word scratch causes DDRXA not to check the 
label on the volume. 


The RESTORE ALL statement tells DDRXA to 
restore the whole tape to the output device. 


Depending on the DASD model you are using, 
you may or may not see this prompt. If you do 
see it, respond yes. The starter system is designed 
to fit on all supported DASD models. 


Informational messages: GMT means Greenwich 
Mean Time. 


The exact cylinder extents vary according to the 
device type. 


When DDRXA finishes, it prompts you with 
ENTER. To end the program, press the ENTER 
key. 


Step 3. Load the VM/XA System Product Starter System and Define 
Devices 


In this step, you will: 


¢ Load the VM/XA System Product starter system 
e Define the devices necessary to perform the system generation. 


This step takes approximately 10 minutes. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


1. Load the VM/XA System Product starter system from the DASD device you just restored it to; that 1s, 
IPL the real address of XASRES. Follow the specified hardware IPL operation for your processor. 
Refer to the proper hardware operation manuals for help. For instance, on the 3081 Processor Complex, 
refer to the /BM 3081 Processor Complex Operator's Guide for the System Console. To prevent 
inadvertent access to the VM/XA starter system, power off all displays not to be used by the program. 


2. If at first you receive no response, press the ENTER key on your display or other displays that are 
connected to the real processor. This action creates the necessary interrupt for the starter system to 
recognize your display and begin execution. 


3. Use Table | on page 7 to answer the questions that the VM/XA System Product starter system asks you. 
The following are the starter system’s informational messages and questions: 


Note: If you do not enter values, the system will use its default values. The system default is shown in 
the right-hand column. However, if the system defaults are not in your IOCDS, the system will 
not be able to use those devices. 


DO YOU WISH TO REDEFINE YOUR SYSTEM (YES/NO): If you have not previously defined your system by 
yes @ executing this substep, answer yes. If you answer 
no your starter system may not IPL properly. 


ENTER PRINTER NUMBER (NNNN): 


rdevno @ ; 
Enter the real device number of your printer. The 


system default is OOOE. 


ENTER DEVICE TYPE (1403, 3203, 3211, 3262, 3800, 3800-1, 3800-3, 4245, 4248): 


devt = ; 
SUEY Pe Enter the device type of your printer. The system 


default is 1403. 
Note: 3800 defaults to 3800 Model |. 


ENTER PUNCH NUMBER (NNNN): 


4 - : ; 
raevno If you press ENTER without typing anything, you 


receive the system default, which is O00D. The 
starter system does. not require a punch actually 
attached to it, but it does create a control block 
for a punch. If you want to use a real punch ata 
device number other than 000D, type in the device 
number and press ENTER. 
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ENTER DEVICE TYPE (2540P,3525): 
devtype 


ENTER READER NUMBER (NNNN): 
rdevno @ 


ENTER DEVICE TYPE (2540R, 2501, 3505): 
devtype @ 


ENTER NUMBER WHERE FIRST TAPE IS MOUNTED (NNNN): 


rdevno & 


ENTER DEVICE TYPE (3420, 3422, 3430, 3480): 
devtype @ 


ENTER THE NUMBER OF A SECOND TAPE DRIVE (NNNN): 


rdevno @& 


ENTER DEVICE TYPE (3420, 3422, 3430, 3480): 
devtype @ 


ENTER DEVICE NUMBER OF WORK PACK (NNNN): 
rdevno @ 
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If you press ENTER, you receive the system 
default, which is 2540P. The starter system does 
not require a punch actually attached to it, but it 
does create a control block for a punch. If you 
want to use a real punch other than the default, 
type in the device type and press ENTER. 


If you press ENTER, you receive the system 
default, which is O00C. The starter system does 
not require a reader actually attached to it, but it 
does create a control block for a reader. If you 
want to use a real reader at a device number other 
than 000C, type in the device number and press 
ENTER. 


If you press ENTER, you receive the system 
default, which is 2540R. The starter system does 
not require a reader actually attached to it, but it 
does create a control block for a reader. If you 
want to use a real reader other than 2540R, type 
in the device type and press ENTER. 


Enter the device number of the real tape device 
where the product tape will be mounted. The 
system default is 0580. 


Enter the device type of your tape drive. The 
system defaults to a device type of 3420. 


You can type in a device number or Just press 
ENTER, in which case you receive the default 
device number, 0581. The starter system does not 
require a second tape drive actually attached at 
0581 or any other device number; the system does 
create a control block for the device. However, 
IBM recommends that you do have a second tape 
drive to send dumps to when the system 1s 
running. 


Enter the device type of your second tape drive. 
The system defaults to a device type of 3420. 


Enter the device number of your second pack 
(XASERV). The system default 1s 0230. 


This pack is required for all DASD types except 
double- or triple-density 3380 DASD (3380-E4 
and 3380-K) or 3390 DASD. 


ENTER DEVICE TYPE (3350, 3375, 3380, 3390): 
devtype 


Enter the device type you are using. 


ENTER NUMBER WHERE EXTRA WORK PACK IS MOUNTED (NNNN): 


rdevno Hi 


ENTER DEVICE TYPE (3350, 3375, 3380, 3390): 
devtype @ 


Enter the device number of your third pack 
(XAP001). The 3350 and 3375 systems require this 
pack. The 3380 and 3390 systems do not require 
an extra work pack. 


Note: If you do not have XAPOO1, you will 
receive this message: 


HCPLND1Q8E MAINT 0124 NOT LINKED 
when you log on as MAINT. If you are 


using 3380 or 3390 DASD, you can ignore 
this message. 


If you press ENTER, you receive the system 
default, which is 0231. 


Enter the device type you are using. 


| 3350 DASD Only | 


ENTER NUMBER WHERE EXTRA WORK PACK IS MOUNTED (NNNN): 


rdevno fi 


ENTER DEVICE TYPE (3350, 3375, 3380, 3390): 
3350 @ 


Enter the device number of your fourth pack 
(XAP002). The 3350 system requires this pack. 


If you press ENTER, you receive the system 
default, which is 0232. 


Po End of 3350 DASD Only _—“—s—s—s—s—SSSCSCidC 


ENTER NUMBER OF A DISPLAY DEVICE (NNNN): 
rdevno 


ENTER DEVICE TYPE (3277, 3278, 3279): 
devtype @ 


This step allows you to define an additional 
display device. This is not the console you are 
presently using. Do not take the default or use 
the address 021. 


Check your installation’s HCPRIO file to see if 
you have defined this display differently. 


Enter the device type of your display. The system 
default is 3278. 
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***SYSTEM DEFINITION COMPLETED*** The numbers shown are those that would appear if 
QOOE PRINTER you always take the default. 

Q00D PUNCH 

QOQC READER 

0580 FIRST TAPE 

Q581 SECOND TAPE 

0230 WORK PACK 

0231 EXTRA WORK PACK 


0232 OTHER WORK PACK You will see this message only if you are using the 

rdevno GRAPHIC DEVICE 3350 starter system. 

ARE THE ABOVE ENTRIES CORRECT (YES, NO): 

yes Answer yes to this question. If you respond no. 
the procedure restarts at the first prompt of this 
step. 


. The Starter System continues: 


VM/XA SYSTEM PRODUCT RELEASE 21 SERVICE LEVEL 0000; 


SYSTEM NUCLEUS CREATED ON mm/dd/yy AT hh:m:ss, 
LOADED FROM XASRES 


KKEKKEKEEKEEKEKREKEEKEKKKEKEKEKRKEKRKEKREKKKKKKEKK 


LICENSED MATERIALS - PROPERTY OF IBM* 


* 
* 
5664-308 (C) COPYRIGHT IBM CORP. 1983, ~* 
1989. ALL RIGHTS RESERVED. ‘ 
US GOVERNMENT USERS RESTRICTED RIGHTS - * 
USE, DUPLICATION OR DISCLOSURE . 
RESTRICTED BY GSA ADP SCHEDULE CONTRACT * 
WITH IBM CORP. . 

* 

* 

* 


* TRADEMARK OF INTERNATIONAL BUSINESS 
MACHINES. 


KEKKEEKKKEKEKKKREKEKRREKKEREKKEKKKKEKKKRKK KKK KE 


+ + + +  F F F F FF F 


HCPISU951I CP VOLID XASERV NOT MOUNTED You may receive the vo/ume not mounted 
HCPISU951I CP VOLID XAPOOQ1 NOT MOUNTED messages. 


START ((COLD|WARM|FORCE) (DRAIN) 
(DISABLE) (NODIRECT) ) | (SHUTDOWN) 


; Since this is the first initialization of the system, 
cold drain @ 


do a COLD start with the DRAIN option. 


NOW hh:mm:ss EST day mm/dd/yy Note: If the clock is not set, you may have to set 
CHANGE TOD CLOCK (YES|NO) the TOD clock using standard operating 
yes Hf procedures. Consult VM/XA SP Real 
SET DATE MM/DD/YY System Operation for those procedures. 
mn/dd/yy Wi 

SET TIME HH:MM:SS 

hh:mm:ss @ 


PRESS "TOD ENABLE SET" KEY AT DESIGNATED INSTANT 
NOW hh:mm:ss EST day mm/dd/yy 

CHANGE TOD CLOCK (YES|NO) 

no @ 
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Note: If you are using a multiprocessor, you may receive a message here concerning the clocks of the 
different images of the processor. If you do, see VM/XA SP Real System Operation for 


information about resetting the clocks. 


THE DIRECTORY ON VOLUME XASRES AT ADDRESS nnnn 
HAS BEEN BROUGHT ONLINE. 
HCPLNDIO8E MAINT 0124 NOT LINKED; 
VOLID XAPQO1 NOT MOUNTED 
HCPLND1O8E MAINT 0125 NOT LINKED; 
VOLID XASERV NOT MOUNTED 


HCPLND1O8E MAINT 0126 NOT LINKED; 
VOLID XAPOQ2 NOT MOUNTED 

THERE IS NO LOGMSG DATA 

FILES: NO ROR, NO PRT, 

LOGON AT hh:mm:ss EST day mm/dd/yy 


HCPIOP9511 CP VOLID volid NOT 
MOUNTED 


NO PUN 


HCPIOP9511 USER VOLID volid NOT 
MOUNTED 


STORAGE = 0016M 
FILES: QQ000001 RDR, O000001 PRT, NO PUN 


. Initialize CMS and enabie all displays: 


VM/XA STARTER SYSTEM 
= 

SYNONYM SYN 

CP TERM MODE VM 


READY; T=n.nn/n.nn hh:mm:ss 


enable all @ 
READY; T=n.nn/n.nn hh:mm:ss 


. Spool MAINT’s console: 


spool cons * start Hf 
READY; T=n.nn/n.nn hh:mm:ss 


CP logs on the primary system operator (user ID 
MAINT). These are informational messages for 
the real system operator. The FILES message 
refers to spool files; there are no spool files in the 
system, since this is a cold start of the system. 


You will see this message only if you are using the 
3350 starter system. 


You may receive a number of informational 
messages that certain volume identifiers (CP volids 
and user volids) are not mounted. You may 
ignore these messages at this time. 


This message tells you the amount of real storage 
available. You must have 16 megabytes. 


The words VM READ appear in the bottom right 
corner of the display screen; when VM READ 
appears, press the ENTER key. 


This command enables all displays available to the 
real system. The VM/XA System Product logo 
appears on all enabled displays. 


This command creates a spool file of all display 
output for the MAINT virtual machine. Spooling 
MAINT’s console can be valuable if problems 
arise and you want to review the system 
generation activity. If you issue this command, 
you will have a record of this activity. When you 
close the file SPOOL CONS CLOSE) or log off, 
the file is automatically sent to your reader. 
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Set the dump to a tape drive or printer address. It is recommended that you use the second tape drive 
you defined for sending dumps to. If you use a tape drive, mount a scratch tape with a ring on the drive. 


set dump rdevno Replace the rdevno with the real device number of 
{TAPE | PRINTER} devno DUMP UNIT CP IPL your tape drive or printer to free up some of the 
spool space. 


Warning: If you do not perform this step, you may run out of SPOOL space later on. In the event of a 
SHUTDOWN and restart at any time during this install procedure, you should perform this substep 
again. 
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Step 4. Attach the VM/XA System Product Release 2.1 Product Tape 
(Volume 1) and Load the First Three Files 


In this step, you will: 


¢ Mount Volume | of the VM/XA System Product product tape on a tape drive 


e Attach the product tape drive to MAINT 
e Load the first three files from the product tape. 


This step takes approximately 5 minutes. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


1. Mount Volume | of the VM/XA System Product product tape (in write-protect mode) on the tape drive 
that you specified as the first tape in “Step 3. Load the VM/XA System Product Starter System and 
Define Devices” on page 17. Follow the operation manual for the machine on which you mount the 
tape. 


2. Attach the tape drive to MAINT at virtual device number 0181: 


attach rdevno * 181 @ The ATTACH command attaches the real device 
TAPE rdevno ATTACHED TO MAINT 0181 (rdevno) to MAINT’s virtual machine at virtual 
READY; T=n.nn/n.nn hh:mm:ss device number 0181. 


3. Check MAINT’s disk accesses. Be sure MAINT’s 191 minidisk is the A disk. 


query search Hf The QUERY SEARCH command tells you what 
MNT191 191A R/W disks you have accessed and the alphabetic order 
MNT190 6190 § R/O of those accesses. When searching for files, CMS 
READY; T=n.nn/n.nn hh:mm:ss uses the alphabetic order of accesses to create a 


search order. CMS searches the A minidisk, if 
accessed, then the B minidisk, if accessed, and so 
forth. 


4. If MAINT’s 191 minidisk is not A, access that minidisk as A: 


access 191 a 
191 REPLACES A (195) 


READY; T=n.an/n.nn hh:mm:ss This message would appear if the QUERY 


SEARCH command had shown MNT195 195 A 
R/W. 


5. For your own convenience, set PF12 as a retrieve key. When you press the retrieve key, the last 
instruction you issued will be displayed. You need only press ENTER to enter it again. 


set pfl2 retrieve You may add this command to your PROFILE 
Ready; T=n.nn/n.nn hh:mm:ss EXEC. 
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vmfpic2 load (eof 3 @ 


$TAPE$ HEADER 


END-OF-FILE OR END-OF-TAPE 


SUPSP21 MEMO 
56643089 SERVICE 


END-OF-FILE OR END-OF-TAPE 


56643089 $PPF 
RPWLIST DATA 
$MSG4I$  EXCAMENG 
$$RDPW$$ EXEC 
$MSG41$ EXEC 
SETUP — EXEC 
SPLOAD EXEC 
UTILITY EXEC 


ITASK EXEC 
DIRECTXA MODULE 
DVM PROFILE 


SPLOAD PROFILE 


END-OF-FILE OR END-OF-TAPE 
READY; T=n.nn/n.nn hh:mm:ss 


Al 


Al 
Al 


Al 
Al 
Al 
Al 
Al 
Al 
Al 
Al 
A2 
A2 
Al 
Al 
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This command loads the first three tape files from 
the product tape. (A tape file is the set of files 
between two tape marks.) These are the only tape 
files you have to load—the ITASK EXEC 
automatically loads the rest of the tape. You will 
receive a message from VMFPLC2 telling you 
which files it loaded. 


The VMSUP memo is loaded to the MAINT 191 
minidisk. Read this memo before going on. 


After you perform Step 8, you may wish to copy 
SUPSP2! MEMO to the CP BASE disk (194 or 
394) to free space on MAINT 191. 


The tools in the third file are installation EXECs. 
You may erase them after you finish the 
installation, except for these files: 


e DIRECTXA MODULE, which ts erased 
during the installation procedure 


¢ SETUP EXEC, which must remain on the 
MAINT 191 minidisk. 


The DIRECTXA MODULE is loaded to MAINT 
191 now so that you can bring your directory 
online in Step 5. It is erased after it is used, then 
reloaded to MAINT 190 in Step 8. If you need to 
reissue ITASK ALLOCATE, you must rewind the 
tape and issue VMFPLC2 LOAD DIRECTXA 
MODULE A (EOT to reload the DIRECTXA 
MODULE from Volume | of the product tape. 


Step 5. Invoke the ITASK EXEC 


In this step, you will use the ITASK EXEC to: 


e Provide a password for user IDs MAINT and OPERATOR 
e Load the sample directory and system definition files 
e Format the XASERV, XAPO0l, and XAP002 volumes. 


The time for this step depends upon the devices involved. It usually takes at least 30 minutes for each 
pack you format. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
haveon your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


Note: A description of the ITASK EXEC and its operands can be found in “ITASK EXEC” on page 611. 


1. Issue ITASK ALLOCATE to supply a password for MAINT and OPERATOR and to format the 
XASERV, XAP001, and XAPO002 volumes: 


Note: The example tn this manual uses a 3380 DASD for the minidisks. If you use a 3350, 3375, 
3380-E4, 3380-K, or 3390, your space allocations and starting address for CMS will differ. 


itask allocate 


REWIND COMPLETE These are informational messages to tell you how 
DMSACC724I 191 REPLACES A (191) the operation is progressing. xx 1s 50, 75, 80, 8E, 
REWIND COMPLETE 83, 90, or 91, according to your DASD type. 


DMSWTK4091I LOADING 33xx * TO 191 ATTACHED TO MAINT 


Note: If ITASK exits with return code 1040, the 123 full-pack minidisk is not attached. 123 1s the 
virtual address of XASRES. You may have to reattach XASRES to your system. 


2. When prompted, enter a new password to be used as both your MAINT and OPERATOR passwords: 


ENTER ONE PASSWORD FOR MAINT AND OPERATOR: You must supply a single password to be used for 
password @ both the MAINT and OPERATOR user IDs. 
The ITASK EXEC will XEDIT the user directory 
and replace NOLOG with the logon password that 
you provide here. 


When selecting a password, refer to the RPWLIST 
DATA file shown in Appendix F, “Restricted 
Logon Passwords” on page 859. This file 
contains all of the restricted passwords for your 
VM/XA SP2.1 system. You cannot choose a 
password for MAINT and OPERATOR that 
exists in this file. 
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ENTER PASSWORD AGAIN TO VERIFY: 


Reenter the password that you have designated for 
the MAINT and OPERATOR user IDs. 


YOU NEED TO REMEMBER THIS 
PASSWORD FOR USE IN LATER STEPS. 
You can write it down on the worksheet—see 
Table 1 on page 7. 


VM/XA SYSTEM PRODUCT USER DIRECTORY CREATION These first messages signify that the user directory 
PROGRAM - RELEASE 2.1 has been created. Then ITASK loads the system 
EQJ DIRECTORY UPDATED AND ON LINE generation tools needed next. 
DMSWSL970I FORMATTING MAINT 193 MINIDISK 
DMSWSL409I LOADING SYSGEN TOOLS TO THE 193 DISK ATTACHED TO MAINT 
DMSWSL9701 FORMATTING MAINT 295 MINIDISK These are messages from ITASK as it loads files 
DMSWSL4Q9I LOADING HCPSYSxx * TO THE 295 DISK from the product tape. The time the ITASK 
ATTACHED TO MAINT EXEC needs to execute varies from system to 
DMSWSL409I LOADING HCPRIOXA * TO THE 295 DISK system. 
ATTACHED TO MAINT 
DMSWSL409I LOADING HCPBOX * TO THE 295 DISK 
ATTACHED TO MAINT 
DMSWSL970I FORMATTING MAINT 395 MINIDISK 
DMSWSL409I LOADING CMSLOC SAMPLES TO THE 395 DISK 
ATTACHED TO MAINT 
DMSACC724I 191 REPLACES A (191) 
DMSWTK965I YOU MAY WISH TO TAILOR THE FOLLOWING You will be able to tailor HCPRIO ASSEMBLE, 
FILES BEFORE NUCLEI GENERATION: HCPBOX ASSEMBLE, and HCPSYS 
ASSEMBLE in “Step 17. Tailor the Sample 
HCPRIO ASSEMBLE HCPRIO, HCPSYS, HCPBOX Files and the 
HCPBOX ASSEMBLE Product Parameter File” on page 55. You will 
HCPSYS ASSEMBLE tailor DMSNGP ASSEMBLE in “Step 14. Tailor 
DMSNGP ASSEMBLE the DMSNGP Profile” on page 46. You will 
USER DIRECT tailor USER DIRECT in “Step 21. Update the 
User Directory” on page 71. 
DMSWTK981I WHAT IS THE REAL ADDRESS OF YOUR XASERV VOLUME? 
DMSWTK982I TYPE: REAL ADDRESS OR SKIP 


rdevno or skip @ Enter the real address, rdevno, of the XASERV 


volume. Refer to your worksheet (Table | on 
page 7) for the label and address of this system 
volume. Check that you typed the right address 
before you press ENTER. 


If you do not want to use XASERYV, or if you 
have already formatted it, enter skip. 


DASD rdevno ATTACHED TO MAINT 301 


CPFMTXA: 


FORMAT WILL ERASE CYLINDERS 0000-nnnn ON DISK 301 


DO YOU WANT TO CONTINUE ? (YES | NO) You need not answer; the EXEC answers YES. 
FORMAT IN PROGRESS ON DISK 301 
CYLINDERS 0 THROUGH 49 FORMATTED 


CYLINDERS nnnn THROUGH nnnn FORMATTED 
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FORMAT COMPLETE 
CURRENT ALLOCATION 
TYPE CYLINDERS 

PERM 0000-nnnn 

ENTER ALLOCATION DATA 
TYPE CYLINDERS 
CURRENT ALLOCATION 
TYPE CYLINDERS 

PERM 0000-nnnn 
ALLOCATE COMPLETE 
VOLUME LABEL IS NOW 'XASERV' 


HCPFAM3841 CPFMTXA COMPLETE 
DASD rdevno DETACHED MAINT 0301 
DASD rdevno ATTACHED TO SYSTEM XASERV 


This message signifies that CPFMTXA has 
completed formatting the XASERV volume. 


The HCPFAM384I message signals the 


completion of this sequence. 


DMSWTK9811I WHAT IS THE REAL ADDRESS OF YOUR XAPQ01 VOLUME? 


DMSWTK982I TYPE: REAL ADDRESS OR SKIP 


rdevno or skip @ 

DASD rdevno ATTACHED TO MAINT 302 

CPFMTXA: 

FORMAT WILL ERASE CYLINDERS Q000-nnnn ON DISK 302 


DO YOU WANT TO CONTINUE ? (YES | NO) 
FORMAT IN PROGRESS ON DISK 302 
CYLINDERS 0 THROUGH 49 FORMATTED 


FORMAT COMPLETE 
CURRENT ALLOCATION 
TYPE CYLINDERS 

PERM 0000-nnnn 

ENTER ALLOCATION DATA 
TYPE CYLINDERS 
CURRENT ALLOCATION 
TYPE CYLINDERS 

PERM 0000-nnnn 
ALLOCATE COMPLETE 
VOLUME LABEL IS NOW 'XAPOOL1' 


HCPFAM384I CPFMTXA COMPLETE 
DASD rdevno DETACHED MAINT 0302 
DASD rdevno ATTACHED TO SYSTEM XAPOO1 
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Enter the real address, rdevno, to allocate the 
XAPOOI! volume. The 3350 and 3375 starter 
systems require XAPOO!. Refer to your worksheet 
(Table | on page 7) for the label and address of 
this system volume. Check that you typed the right 
address before you press ENTER. 


If you do not want to use XAPOO1I, or if you have 
already formatted it, enter skip. 


You need not answer; the EXEC answers YES. 


This message signifies that CPFMTXA has 
completed formatting the XAPOO! volume. 


The HCPFAM384I message signals the 
completion of this sequence. 


Z7 


iii 3350 DASD Only 


DMSWTK981I WHAT IS THE REAL ADDRESS OF YOUR XAPOO2 VOLUME? 
DMSWTK9821 TYPE: REAL ADDRESS OR SKIP 


rdeyno or skip Enter the real address, rdevno, to allocate the 
DASD rdevno ATTACHED TO MAINT 303 XAP002 volume. The 3350 starter system requires 
CPFMTXA: XAPO002. Refer to your worksheet (Table | on 


FORMAT WILL ERASE CYLINDERS 0000-nnnn ON DISK 303 page 7) for the label and address of this system 
volume. Check that you typed the right address 
before you press ENTER. 


If you have already formatted XAPO02, enter skip. 


DO YOU WANT TO CONTINUE ? (YES | NO) You need not answer; the EXEC answers YES. 
FORMAT IN PROGRESS ON DISK 303 
CYLINDERS 0 THROUGH 49 FORMATTED 


FORMAT COMPLETE This message signifies that CPFMTXA has 
CURRENT ALLOCATION completed formatting the XAPO02 volume. 
TYPE CYLINDERS 

PERM 0000-nnnn 

ENTER ALLOCATION DATA 

TYPE CYLINDERS 

CURRENT ALLOCATION 

TYPE CYLINDERS 

PERM 00Q00-nnnn 

ALLOCATE COMPLETE 

VOLUME LABEL IS NOW 'XAPQQ2' 


HCPFAM384I1 CPFMTXA COMPLETE The HCPFAM384I message signals the 
DASD rdevno DETACHED MAINT 0303 completion of this sequence. 
DASD rdevno ATTACHED TO SYSTEM XAPOQO2 


Pond of 3350 DASD Only __——CsSSSCSCSCsdC 
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READY; T=n.nn/n.nn hh:mm:ss This message tells you that the ITASK EXEC has 
completed the sequence for each volume needed 
for installing VM/XA System Product Release 2.1. 
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Step 6. Format the Remaining Base CP Minidisks 


In this step, you will use the ITASK EXEC to format the remaining minidisks that are defined in the CP 
directory, but have not yet been formatted or loaded in a previous step. ITASK also puts a PROFILE 
EXEC on the 191 minidisk for EREP and DISKACNT. 


The time to perform this step may vary, but a good estimate is 45 minutes. 


1. Use the ITASK EXEC with the BASEIDS parameter to format, load, and add (as appropriate) 
PROFILE EXECs to the remaining minidisks in the base CP directory. If you issue ITASK BASEIDS 
from a user ID other than MAINT, it will format that user ID’s minidisks instead of MAINT’s. 


Note: The block sizes of the 190 and 490 minidisks have increased from 1KB to 4KB for minidisk 
caching. The Starter System defines the 190 and 191 minidisks (formatting the 191 disk with a IKB 
block size), while the ITASK BASEIDS step formats all other minidisks with a 2KB block size. 


If you choose to format a minidisk with a block size of 4K B, the number of cylinders for that minidisk 
may have to be increased, as is the case for the HELP disks. 


itask baseids Hi 
DMSWTK1310I DO YOU WANT TO FORMAT MINIDISKS: 
AUTOLOG1 (191), CMSBATCH (195), DISKACNT (191), 
MAINT 36E (PVM), EREP (191), AND OPERATNS (191)? 
DMSWTK8005R TYPE: 1 (YES) OR O (NO). 
1 wf 


DMSWTK968I THE FOLLOWING MINIDISKS 
DEFINED IN THE BASE CP DIRECTORY 
WILL BE FORMATTED: 


MAINT 292 MAINT 49C 
MAINT 194 MAINT 49D 
MAINT 19C MAINT 501 
MAINT 19D MAINT 591 
MAINT 19E MAINT 592 
MAINT 201 MAINT 593 
MAINT 291 MAINT 594 
MAINT 293 MAINT 595 
MAINT 294 MAINT 596 
MAINT 391 MAINT 59E 
MAINT 392 MAINT 5E5 
MAINT 393 MAINT 691 
MAINT 394 MAINT 692 
MAINT 423 MAINT 791 
MAINT 490 MAINT 892 
MAINT 491 MAINT 895 
MAINT 492 MAINT 896 
MAINT 495 MAINT 89E 


DMSWTK970I FORMATTING AUTOLOG1 191 MINIDISK 
DMSWTK970I FORMATTING CMSBATCH 195 MINIDISK 
DMSWTK970I FORMATTING DISKACNT 191 MINIDISK 
DMSWTK969I A PROFILE EXEC HAS SUCCESSFULLY 
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BEEN 
DMSWTK9701 
DMSWTK9691 

BEEN 
DMSWTK970I 
DMSWTK970I 
DMSWTK9701I 
DMSWTK9701 
DMSWTK970I 
DMSWTK970I 
DMSWTK970I 
DMSWTK9701 
DMSWTK9701 
DMSWTK970I 
DMSWTK970I 
DMSWTK976I 
DMSWTK970I 
DOMSWTK9701 
DMSWTK970I 
DMSWTK9701 
DMSWTK970I 
DMSWTK970I 
DMSWTK9701 
DMSWTK9701 
DMSWTK970I 
DMSWTK970I 
DMSWTK9701 
DMSWTK970I 
DMSWTK970I 
DMSWTK9701 
DMSWTK9701 
DMSWTK970I 
DMSWTK970I 
DOMSWTK970I 
DMSWTK9701I 
DMSWTK9701 
DMSWTK970I 
DMSWTK9701 
DMSWTK970I 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 


COPIED TO DISKACNT'S 191 MINIDISK 


FORMATTING EREP 191 MINIDISK 


A PROFILE EXEC HAS SUCCESSFULLY 


COPIED TO EREP'S 191 MINIDISK 
FORMATTING MAINT 36E MINIDISK 


FORMATTING OPERATNS 191 MINIDISK 


FORMATTING MAINT 292 MINIDISK 
FORMATTING MAINT 194 MINIDISK 
FORMATTING MAINT 19C MINIDISK 
FORMATTING MAINT 19D MINIDISK 
FORMATTING MAINT 19E MINIDISK 
FORMATTING MAINT 201 MINIDISK 
FORMATTING MAINT 291 MINIDISK 
FORMATTING MAINT 293 MINIDISK 
FORMATTING MAINT 294 MINIDISK 
FORMATTING MAINT 391 MINIDISK 
FORMATTING MAINT 392 MINIDISK 
FORMATTING MAINT 393 MINIDISK 
FORMATTING MAINT 394 MINIDISK 
FORMATTING MAINT 423 MINIDISK 
FORMATTING MAINT 490 MINIDISK 
FORMATTING MAINT 491 MINIDISK 
FORMATTING MAINT 492 MINIDISK 
FORMATTING MAINT 495 MINIDISK 
FORMATTING MAINT 49C MINIDISK 
FORMATTING MAINT 49D MINIDISK 
FORMATTING MAINT 501 MINIDISK 
FORMATTING MAINT 591 MINIDISK 
FORMATTING MAINT 592 MINIDISK 
FORMATTING MAINT 593 MINIDISK 
FORMATTING MAINT 594 MINIDISK 
FORMATTING MAINT 595 MINIDISK 
FORMATTING MAINT 596 MINIDISK 
FORMATTING MAINT 59E MINIDISK 
FORMATTING MAINT 5E5 MINIDISK 
FORMATTING MAINT 691 MINIDISK 
FORMATTING MAINT 692 MINIDISK 
FORMATTING MAINT 791 MINIDISK 
FORMATTING MAINT 892 MINIDISK 
FORMATTING MAINT 895 MINIDISK 
FORMATTING MAINT 896 MINIDISK 
FORMATTING MAINT 89E MINIDISK 


DASD 333 DETACHED 


READY; T=n.nan/n.nn hh:am:ss The ready message indicates that ITASK has 


completed its work successfully. 


2. If any of the minidisks listed in message DMSWTK968I were not formatted, check your work packs to 
make sure that they are labeled XASERV, XAPOO1, and XAPOQ02, and that they are attached to the 
system. Then reissue ITASK BASEIDS. 


3. Continue with the next step. 
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Step 7. ITASK Loads Files from the Product Tape (Volume 1) 


In this step, you will issue the ITASK EXEC to load files from Volume | of the product tape. 


This step takes approximately 30 minutes. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


1. Enter the ITASK command with the LOAD ALLI operands to load the CP and dump viewing facility 
object code and service files. If a problem should occur during this step, or 1f for some reason you want 
to return to this step and load product tape files, see “ITASK EXEC” on page 611 to reload the 
particular files you need. 


itask load alll @ 
DMSWSL409I LOADING SYSTEM SAMPLES TO 

THE 191 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CP OBJECT TO 

THE 194 DISK ATTACHED TO MAINT 
DMSWSL4091I LOADING CP PUTAPPLY TO 

THE 292 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CP PUTDELTA TO 

THE 294 DISK ATTACHED TO MAINT 
DMSWSL4091 LOADING CP CORAPPLY TO 

THE 292 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CP CORDELTA TO 

THE 294 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING DUMPVIEW OBJECT TO 

THE 193 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING DUMPVIEW PUTAPPLY TO 

THE 392 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING DUMPVIEW PUTDELTA TO 

THE 293 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING DUMPVIEW CORAPPLY TO 

THE 392 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING DUMPVIEW CORDELTA TO 

THE 293 DISK ATTACHED TO MAINT 
READY; T=n.nn/n.nn hh:mm:ss 


These are messages from ITASK as it loads more 
files from the product tape. The time the ITASK 
EXEC needs to execute varies from system to 
system. 
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Step 8. ITASK Loads Files from the Product Tape (Volume 2) 


In this step, you will issue the ITASK EXEC to load files from Volume 2 of the product tape. 


This step takes approximately 30 minutes. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


1. Mount Volume 2 of the product tape. 


2. Issue ITASK LOAD CMS to load the CMS object code, source code, and service files and the IOCP 
files: 


itask load cms @ 
DMSWSL409I LOADING CMS BASE TO 
THE 193 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING IOCP FILES TO 
THE 193 DISK ATTACHED TO MAINT 
DMSWSL4091 LOADING CMS PUTAPPLY TO 
THE 392 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CMS PUTDELTA TO 
THE 293 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CMS CORAPPLY TO 
THE 392 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CMS CORDELTA TO 
THE 293 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CMS SYSTEM TO 
THE 190 DISK ATTACHED TO MAINT 


3. The ITASK EXEC invokes the SETUP EXEC to establish the minidisk access order, then the 
ASMGEND EXEC to build the system F assembler and create the associated auxiliary directory: 


DMSACC724I 191 REPLACES A (191) 


DMSACC7241 190 REPLACES A (191) 

DMSACC725I 190 ALSO = S DISK 

ASSEMBLE XF GEND PROC 

ENTER TARGET DISK MODE FOR ASSEMBLE MODULES 
DEFAULTS TO S-DISK IF NONE ENTERED. 


a Press ENTER to place the modules on the S-disk, 
the system default. 


Enter another disk-mode letter if you prefer the 
modules to be placed on another minidisk. 


ASSEMBLE XF GEND COMPLETE 


DMSACC724I 191 REPLACES A (190) 
READY; T=n.nn/n.nn hh:mm:ss 
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Notes: 


a. At this time, you may choose to copy the documentation file (SUPSP21 MEMO) to the CP BASE 
disk as suggested in Step 4, substep 6 on page 24. 


b. You may choose to load HELP files, CP, CMS, and dump viewing facility source files, and GCS 
object files at this time. The following is an alternative order for loading these files that will 
minimize tape mounts: 


1) Load HELP files from Volume 2. (See Step 22 on page 72.) 
2) Load GCS object files from Volume 2. (See Step 26, substep 3 on page 78.) 


3) Load CP, CMS, and dump viewing facility source files from Volume 3. (See Step 23 on page 
73.) 
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Step 9. Establish the Service Tools Build Disk 


In this step, you copy the latest level of the service tools to the service tools build disk. 


This step takes approximately 10 to 15 minutes. 


To be sure that you are using the most recent service EXECs, you must have the latest level of service on a 
service tools build disk. This disk, SES, is defined in the sample directories. It is the only disk in the TASK 
string in the product parameter file. 


I. 
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IPL 190: 


ip] 190 clear @ 

VM/XA STARTER SYSTEM 

a 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


. Establish the correct minidisk access order and create a work EXEC to help you copy the service tools: 


setup I 
Ready; T=n.nn/n.nn hh:mm:ss 
DMSACC724I vdevno replaces fm (vdevno 


vmfsetup 56643089 cms @ 
DMSACC724I vdevno replaces fm (vdevno 


Ready; T=n.nn/n.nn hh:mm:ss 


xedit Ivlses exec fm fm is the filemode of the task disk (SES). 
input @ 
&TRACE OFF Enter these lines exactly as they appear. 


&FT = &LEFT OF &2 2 
&FT = &CONCAT OF &FT * 
EXEC FILELIST &1 &FT * 


&EXIT O 

|_| Press ENTER twice to return to the command 
el line. 

file 


Look for the latest version of the CPYSVSES EXEC or CPYSVSES EXCnnnnn. CPYSVSES contains a 
list of all the service EXECs. 


filelist cpysvses * * Hi Examine each version of CPYSVSES. CPYSVSES 
has an update history at the top. The latest level 
is one with the most updates. Use the update 
history, not the date and time stamp, to determine 
which 1s the most recent version. 
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| 4. Copy the latest level of CPYSVSES to the task disk (SE5) with a filetype of EXEC: 


| copyfile / = exec fm (olddate replace H Issue this command from the FILELIST screen. 
| Ready; T=n.nn/n.nn hh:mm:ss on the line listing the file you want to copy. 


| 5. Invoke CPYSVSES EXEC: 


| cpysvses exec Ivlses Mf 
| Ready; T=n.nn/n.nn hh:mm:ss 


| 6. CPYSVSES EXEC invokes LVLSES, which invokes FILELIST to display each entry for each service 
| EXEC listed in CPYSVSES. Process each FILELIST screen as follows: 


| a. For each of the files on the FILELIST screen, determine which is the latest version. Do not depend 
| on the date and time stamps; examine the actual files. Each file ends with an update summary that 
| indicates the file’s service history. The latest version is the one with the most service. Files with 

| filetypes of EXCnunnnn, MODnnnnn, XEDnnnnn, and PRFnnnnn are exact images of the 

| corresponding EXEC, MODULE, XEDIT, and PROFILE executables. 


| b. Copy the latest files to the task disk (SES), using the OLDDATE REPLACE options. Assign the 
| copy a filetype of EXEC, MODULE, XEDIT, or PROFILE: 


| copyfile / = ft fm (olddate replace Issue this command from the FILELIST screen, 
| on the line listing the file you want to copy. 


| c. Press PF3 to exit this FILELIST screen and go to the next screen. 
| d. Continue until there are no more FILELIST screens. 


| 7. Look for the latest version of the product parameter file: 


| filelist 56643089 * * Hf Examine each version of the product parameter 

| file. A sample product parameter file 1s shown in 

| “A Sample Product Parameter File” on page 384. 

| The product parameter file has an update history 

| at the top. The latest level is the one with the 

| most updates. Use the update history, not the date 
| and time stamp, to determine which is the most 

| recent version. 


| 8. Copy the latest level of the product parameter file to the task disk (SES): 


| copyfile / = $ppf fm (olddate replace @ Issue this command from the FILELIST screen, 
| Ready; T=n.nn/n.nn hh:mm:ss on the line listing the file you want to copy. 


| 9. Now that the service tools are all on the service tools build disk, you do not need to issue SETUP again. 
| Instead, simply access SES as B. You may wish to add this access to MAINT’s PROFILE EXEC. 


| access 5E5 b @ 
| Ready; T=n.nn/n.nn hh:mm:ss 
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10. Check MAINT 191 (your A-disk) for files with the same filename as files on the task disk (SE5). Erase 
any duplicate files from MAINT 191 (your A-disk) so that you will not invoke any back-level service 
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EXECs. 


filelist * * b Hf 
PF9 


erase 
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This command lists all the files on your B-disk. 


Pressing PF9 on the FILELIST screen lists all the 
files with the same filename as the one where the 
cursor is positioned, with any filetype and on all 
disks. See if there is one with the same filename 
on the A-disk. 


Enter this command on the line listing the file you 
want to erase. Be sure to erase the file only on the 
A-disk (191), not on the B-disk (5E5) or any other 
disk on which it may appear. 


Step 10. Set the System Default National Language 


In this step, you will set the system default national language. 


This step takes approximately 20 minutes. 


The system default national language is mixed-case American English. This means that most system 
messages and HELP files will appear in mixed case (capital and small letters). Some will appear in uppercase 
(capital letters only). 


Decide whether you want to keep the system default as mixed-case American English or change it to 
uppercase American English (in which case all system messages and HELP files will be in uppercase). Follow 
the appropriate instructions below. 


If you want to instail a system default national language other than American English, you will be able to do 
so after you finish the installation process. See Chapter 5, “Installing a New System National Language” on 
page 311 for instructions. 


If you want to install an alternate system national language (including whichever version of American English 
is not your default), see VM/XA SP Planning and Administration. 


Mixed-Case American English 


If you want to keep the system default national language as mixed-case American English, you should 
convert the installation messages to mixed case. (If you do not do so, all the installation messages will 
continue to appear in uppercase, but most other system messages will appear in mixed case.) 


1. Save the uppercase installation message file: 


rename $msg4i$ exec a = excuceng = @ 
READY; T=n.nn/n.nn hh:mm:ss 


2. Rename the mixed-case installation message file: 


rename $msg4i$ excameng a = exec = @ 
READY; T=n.nn/n.nn hh:mm:ss 


Notes: 
1. You may see the following message when you IPL CMS: 


DMSINS283E The NLSAMENG saved segment could not be found; 
return code 44 from SEGMENT 


This is an informational message. You can ignore tt. 


2. If you receive service for $MSG4I$ EXEC, the service will be in uppercase. You do not have to convert 
it to mixed case. 
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Uppercase American English 


If you want to change the system default to uppercase American English, you must: 


ie 


Edit the product parameter file and change all :NLS. tags from AMENG to UCENG: 


xedit 56643089 $ppf mi 


ch/:NLS. AMENG/:NLS. UCENG/* * @ There are six blanks after :NLS. in the XEDIT 
file @ change command. 


. Save DMSNGP TEXT, then rename the DMSNGP TXTUCENG file DMSNGP TEXT. This gives you 


a TEXT file assembled from a DMSNGFP profile with LANGID = UCENG and HELP=19C. 


Note: You will be able to make other changes in the DMSNGP profile in Step 14, after you install 
Assembler H. You will have to change the LANGID= and HELP= parameters in Step 14. The 
DMSNGP TXTUCENG file is provided here only to allow you to specify uppercase American 
English as your system default national language. 


access 395 d 
DMSACC7241 395 REPLACES D(395) 
READY; T=n.nn/n.nn hh:mm:ss 


rename dmsngp text d = txtameng = @ 
READY; T=n.nn/n.nn hh:mm:ss 
rename dmsngp txtuceng d = text = @ 


READY; T=n.nn/n.nn hh:mm:ss 


. Convert SVMFMSG$ EXEC (the service message file) to uppercase: 


xedit $vmfmsg$ exec Mf 
uppercas * Hf 
file @ 


Notes: 


l. 


2. 
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You may see the following message when you IPL CMS: 


DMSINS283E The NLSUCENG saved segment could not be found; 
return code 44 from SEGMENT 


This is an informational message. You can ignore it. 


If you receive service for $VMFMSG$§ EXEC, the service will be in mixed case. You will have to 
convert it to uppercase. If you receive service for the DMSNGP profile or the product parameter file, 
you will have to update them again. 
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Step 11. Build CMS 


In this step, you will build CMS. 


This step takes approximately 5 minutes. 


1. IPL 190 and issue ITASK BUILD CMS to invoke the CMS BUILD process: 


ip] 199 clear @ 

VM/XA STARTER SYSTEM 

a 

SYNONYM SYN 

CP TERM MODE VM 

READY; T=n.nn/n.nn hh:mm:ss 


spool punch * # 
Ready; T=n.nn/n.nn hh:mm:ss 


itask build cms 
nnnnnnnn files changed 


DMSACC724I 191 replaces A(191) 
DMSACC724I 5E5 replaces B(5E5) 


DMSWSU1L9OOW The existing 56643089 $SETUP Al 
file has been refreshed. You 
might want to check your access 
order when done. 


LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


RDR FILE fileno SENT FROM MAINT PUN AS fileno 
RECS nnnk COPY 001 NOHOLD NOKEEP 


DMSWSU1906E The access of 19E failed with a 
return code of 28. Processing 
stops for product 56643089. 
The original access order cannot 
be restored. 


Ready; T=n.nn/n.nn hh:mm:ss 


ITASK invokes the SETUP EXEC to create the 
correct CMS access order. 


You will see this message only if you have a copy 
of 56643089 $SETUP on your A-disk. If you do 
see it, you will get return code 4. 


A temporary load list is created and the system 
loader is invoked. 


The CMS nucleus has been sent to your reader. 


The access failed because 19E is empty. You may 
receive this message. It is not a problem. You 
will reaccess 19E when you re-IPL 190. If you see 
this message, you will get return code 4. 


If you get return code 4, the reason may be that a 
PTF which is now being applied has another PTF, 
outside CMS, as a prerequisite. Check the 
SVMFBLD S$ERRLOG file for message 
DMSBNC1854W. 


. Review the build exception log ($3VMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build & 
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. Ensure that the proper files are in MAINT’s virtual reader: 


query rdr maint all @ The ALL operand asks for a display of all 
information about the reader files. 

ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT = nnnn * PUN nnnnnannn Q01 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 


Ready; T=n.nn/n.nn hh:mm:ss 
This is the file that you will IPL in substep 7 
below. It has approximately 28,000 records. The 
exact size varies according to the system default 
language, local modifications, and VMSUP level. 


. Order your reader so that the CMS nucleus will be processed first: 


order rdr fileno @ fileno is the file number of the CMS nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


. Ensure that the virtual reader is readied for class * reader files: 


query virtual 00c @ 

RDR Q0O0C CL ci NOCONT NOHOLD EOF READY 
Q00C 2540 CLOSED KEEP 

Ready; T=n.nn/n.nn hh:mm:ss 


. If the virtual reader is not class *, issue: 


spool rdr class * keep @ The KEEP option places the spool file in USER 
Ready; T=n.nn/n.nn hh:mm:ss HOLD status after it has been read. To remove 
this file from your reader, issue purge rdr /ileno, 
where fileno is the file number of the reader file. 


. Load (IPL) MAINT’s virtual reader: 


ip] 00c clear 


HCPLDR8Q13I Possible overlay: .SLC Q00000 If you see either of these messages, you can ignore 
them. They are informational messages. 
DMSINS283E The NLSlangid saved segment could not be found; 
return code 44 from SEGMENT 


DMSINQ609R Nucleus (CYL or BLK) address = 


i w 

— Enter the correct starting cylinder address for the 
DASD type of your 190 minidisk: 
Device Cylinder Address 
3350 068 
3375 105 
3380 066 
3390 062 

DMSINQ612R Enter version identification: Press ENTER for the default version 

= identification, VM/XA CMS 5.6 min/dd/yy hh:mm. 


You will be able to modify the default in Step 14. 
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DMSINQ612R Enter installation heading: Press ENTER for the default heading, VM/XA 
a CONVERSATIONAL MONITOR SYSTEM. 
You will be able to modify the default in Step 14. 


DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 
| 

SYNONYM SYN 

CP TERM MODE YM 


Informational message: The optional installation 
segment (CMSINST) is not loaded and saved until 
“Step 29. Create the CMSINST and HELP Saved 
Segments” on page 103 is completed. 


Ready; T=n.nn/n.nn hh:mm:ss 


8. You may want to load the printer image library at this time. If you do, see “Step 25. Install the Printer 
Image Library” on page 75S. 
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Step 12. Save and Print the CMS Load Map 


In this step, you will: 


¢ Save a load map of CMS on the CMS LOCALI disk 


e¢ Print a copy of the load map. 


This step takes approximately 5 minutes. 


1. 
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The CMS load map has been spooled to MAINT’s virtual printer. Ready the printer to send the CMS 
load map to MAINT’s virtual reader: 


spool prt * nohold @ 
Ready; T=n.nn/n.nn hh:mm:ss 
close prt * 


RDR FILE fileno SENT FROM MAINT The CMS load map has been sent to MAINT’s 
PRT AS fileno RECS nnnn COPY 001 A NOHOLD NOKEEP virtual reader. If you do not get this message, it 
has already been sent there by a previous IPL 190. 


. If the CMS load map is sent to MAINT’s virtual printer instead of the reader, transfer it to the virtual 


reader: 


transfer prt fileno * rdr Hf 

RDR FILE fileno TRANSFERRED FROM * FILE fileno 
Q001 FILE TRANSFERRED 

Ready; T=n.nn/n.nn hh:mm:ss 


. Identify the reader file: 


query rdr * all @ 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 
MAINT  fileno M-PUN nnnnnnnn 001 NONE mm/dd hh:mm:ss SYSPROG 


The CMS load map is the file with a blank 
filename and filetype. It has approximately 8100 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUP level. Note the ftleno of this file. You 
will use it in your next command. 


. Bring in the file from the virtual reader to the CMS LOCAL] disk: 


access 395 d The CMS map 1s loaded on the CMS LOCALI 
Ready; T=n.nn/n.nn hh:mm:ss disk. 

receive fileno fn ft @ 

File fn ft D received from MAINT at * sent as (none) (none) D 

Ready; T=n.nn/n.nn hh:mm:ss 
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You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as | —9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 


5. Print a copy of the CMS load map. If you do not have a printer attached, skip this substep. 


spool 00e to system class a @ 
Ready; T=n.nn/n.nn hh:mm:ss 
print fn ft d H 

Ready; T=n.nn/n.nn hh:mm:ss 


6. Examine the load map for errors. Verify that the new updates have been included in the CMS nucleus: 


xedit fn ft BB 
qquit 


7. Continue with the next step. 
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Step 13. Install Assembler H Version 2 Program Product 


Note: IBM packages Assembler H Version 2 as a separate program product. This program product has its 
own installation procedure. 


In this step, you will: 


e Consult Assembler H Version 2 Program Product: Installation, SC26-4030 
e Install Assembler H Version 2 Program Product, VM* feature 
e Install service for Assembler H Version 2. 


The time to perform this step may vary, but a good estimate is 20 minutes. 


1. Before you install Assembler H, consult your IBM Support Center for the latest information on APARs. 
2. Read the /nstallation manual for Assembler H Version 2 Program Product. 


3. Refer to “Installing Program Products” in the VM/XA SP2.1 Program Directory for more information on 
Assembler H. 


4. Follow the directions in the /nstallation manual to install Assembler H Version 2. IBM advises you to 
install Assembler H Version 2 on the 19E minidisk. 


Note: Use the OBJECT option to assemble Assembler H CSECTS. 


5. During the installation of Assembler H Version 2, answer YES to the question “BUILD AN 
AUXILIARY DIRECTORY?” and respond Y to the question asking what mode letter you want to use 
to access the disk containing the H-Assembler modules. 


6. Erase IEV61 TEXT. If you do not erase this file, you will not be able to apply service to Assembler H. 
7. Install the latest service level of Assembler H. 
8. After you have finished installing service for Assembler H, IPL 190: 

ipl] 190 clear Hf 

DMSINS327I The installation saved segment could not be loaded 

VM/XA CMS 5.6 mm/dd/yy hh:mm 

a 

SYNONYM SYN 


CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 


VM 1s a trademark of the [BM Corporation. 
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9. Check MAINT 191 (your A-disk) for files with the same filename as files on the task disk (5E5). Erase 
these duplicate files from MAINT 191 (your A-disk) so that you will not invoke any back-level service 


EXECs. 


filelist * * fm @ 


PFO 


erase Hi 


processing. 


This command lists all the files on the task disk 
(SES). 


Pressing PF9 on the FILELIST screen lists all the 
files with the same filename as the one where the 
cursor 1s positioned, with any filetype and on all 
disks. See if there is one with the same filename 
on the A-disk. 


Enter this command on the line listing the file you 
want to erase. Be sure to erase the file only on the 
A-disk (191), not on the task disk (SES). 


. If any unneeded service memos exist on the MAINT 191 disk, erase them to make room for further 
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Step 14. Tailor the DMSNGP Profile 


In this step, you will use the VM System Product Editor (XEDIT) supplied with the starter system to 
tailor the CMS nucleus generation profile (DMSNGP). 


This step, excluding time for printing system definition files, takes approximately 15 minutes. 


l. 
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Before proceeding with this step, read the discussion of the DMSNGP profile in VM/XA SP Planning 
and Administration, under the discussion of the DEFNUC macro. DMSNGP ASSEMBLE is a profile 
that contains CMS configuration defaults and responses to system prompts; these will become part of the 
CMS nucleus. 


IPL 190: 


ip! 190 clear @ 

DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

| 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


. Access the CMS LOCALI minidisk, where DMSNGP resides, as D: 


access 395 d In this example, the DMSNGP file resides on the 
: 395 disk. 


Ready; T=n.nn/n.nn hh:mm:ss 


. Save a copy of DMSNGP ASSEMBLE, so that if you make a mistake in changing it, you can go back to 


the original file: 


copyfile dmsngp assemble d = oldassem = (olddate @ 
Ready; T=n.nn/n.nn hh:mm:ss 


. XEDIT the CMS nucleus generation profile: 


xedit dmsngp assemble Mf Within the file, you can use the normal XEDIT 
cursor-control keys, scroll keys. insert key, and 
delete key. 
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NGP TITLE *DMSNGP 


(CMS) 


VM/XA SYSTEM PRODUCT 5664-308' 


EJECT 
DMSNGP CSECT 

DEFNUC SYSDISK=190, * § disk address 
YDISK=19E, * Y-disk address 
HELP=19D, * Help disk address 
LANGID=AMENG, * Default is American English 
DBCS=NO, * Default is not a DBCS lang 
LANGLEV=S, * DCSS ID for multiple DCSS 


SAVESYS=NO, 
SYSNAME=CNS , 
USEINST=YES, 


INSTSEG=CMSINST, 


REWRITE=YES, 
IPLADDR=190, 


* Using CMS in DCSS yes or no 
* Name of above DCSS to save 
* Using EXEC/XEDIT in DCSS 

* Name of above DCSS to save 
* Write nucleus yes or no 

* Address of where to write 


+ £ ££ + © €£ &€+ © & HH HF £ HF 


CYLADDR=?, * CYL/BLK OF WHERE TO WRITE 
IPLCYLO=YES, * Write IPL text on cy] 0 
VERSION=?, * VM/XA CMS 5.6 MM/DD/YY HH MM SS* 


INSTID='VM/XA CONVERSATIONAL MONITOR SYSTEM' 
END 


6. Look at the DEFNUC defaults, and make any necessary changes. Refer to VM/XA SP Planning and 
Administration for information on the DEFNUC macro. 


Warning: The comma at the end of each line of the DEFNUC macro is required in all lines but the last 
line. If you omit this comma in any line other than the last line, all the lines after the first line without a 
comma are ignored. 


Warning: On each line, make sure that you leave at least one blank between the comma and the 
comment. 


¢ Ata minimum, you should change CYLADDR =?, to indicate the starting cylinder on the MAINT 
190 minidisk at which to start writing the CMS nucleus. The appropriate starting cylinder depends 
on the device type of the DASD where the MAINT 190 minidisk is defined: 


Device Cylinder Address 
3350 068 
3375 105 
3380 066 
3390 062 


If you do not replace the question mark for the CYLADDR keyword, you receive the following 
‘prompt when you generate the CMS nucleus: 


DMSINI609R Nucleus (CYL or BLK) address = 
You must respond with the appropriate cylinder address. 


e If you specify YES after the SAVESYS option, you must create a skeleton named saved segment 
(NSS) before building the CMS nucleus. This segment is saved when you build CMS and IPL your 
reader. (You will get message HCPNSS4401.) 


A skeleton segment for the CMS nucleus is created by the SAMPNSS EXEC. You can also create 
your own skeleton segment with the DEFSYS command. For information on the DEFSYS 
command, see VM/XA SP CP Command Reference and VM/XA SP Virtual Machine Operation. 
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e Make sure the LANGID and HELP parameters are right for your system default national language: 


Language LANGID HELP 


Mixed-case American English AMENG 19D 
Uppercase American English UCENG 19C 


e Make any other changes you wish. For example, you may want to change the version identifier or 
the installation header. You must put single quotes around your version identifier and installation 
header. The character string between the single quotes can be any combination of alphanumeric 
characters. 


file = = fm Make your changes and file the update file on the 
CMS LOCAL] (395) disk. 


. Assemble the new DMSNGP file: 


itask assemble dmsngp @ 


: The minidisk access order is reestablished. 
DMSUPD181E No update files were found 


DMSWHM1907I Assembling DMSNGP 


Note: If an error occurs during the assembly, examine the flagged statements and correct the statements 
in error. Then continue from the beginning of this step. 


DMSWHM1909I DMSNGP TEXT A created The DMSNGFP file has been assembled and placed 
PRT FILE fileno SENT FROM MAINT PUN AS fileno onthe MAINT 191 minidisk. 

RECS nnnn COPY 001 A NOHOLD NOKEEP 
Ready; T=n.nn/n.nn hh:mm:ss 


. Copy the text deck from MAINT 191 to MAINT 395, then erase it from MAINT 191: 


copy dmsngp text a = = fm (replace @ jm is the filemode of the CMS LOCAL]! minidisk. 
Ready; T=n.nn/n.nn hh:mm:ss 

erase dmsngp text a @ 

Ready; T=n.nn/n.nn hh:mm:ss 


If you did not replace the question mark for the CYLADDR keyword, when you generate the CMS 
nucleus, you will receive the following message: 


Message Appropriate Response 


DMSINI609R Nucleus (CYL or BLK) address = nnnnn 
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nnnnn is the location on the 190 disk where the new 
CMS nucleus is written. Refer to the table on page 
47 to determine the correct response for your DASD 
type. 
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Step 15. ITASK EXEC Rebuilds the CMS Nucleus 


Note: Do this step only if you have changed the DMSNGP file in Step 14. 


In this step, the ITASK EXEC: 


e Creates a CMS nucleus 


e Places the CMS nucleus on the CMS residence disk. 


This step takes approximately 5 minutes. 


1. Spool punch output to your own virtual reader: 


spool punch * # 
Ready; T=n.nn/n.nn hh:mm:ss 


2. Issue ITASK BUILD CMS to create the CMS nucleus. By issuing the ITASK EXEC, you will 
incorporate updated CMS text files into a new CMS nucleus. 


itask build cms 
nnnnnnnn files changed 


DMSWSU1900W The existing 56643089 $SETUP Al 
file has been refreshed. You 
might want to check your access 
order when done. 


LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


RDR FILE fileno SENT FROM MAINT PUN AS fileno 
RECS nnnK COPY 001 NOHOLD NOKEEP 


Ready; T=n.nn/n.nn hh:mm:ss 


ITASK invokes the SETUP EXEC to create the 
correct CMS access order. 


You will see this message and return code 4 only if 
you did not erase 56643089 $SETUP in Step 11. 


A temporary load list is created, and the system 
loader 1s invoked. 


The CMS nucleus has been sent to your reader. 


If you get return code 4, the reason may be that a 
PTF now being applied has another PTF, outside 
CMS, as a prerequisite. Check the S$VMFBLD 
SERRLOG file for message DMSBNC1854W. 


3. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vnfview build @ 


4. Ensure that the proper files are in MAINT’s virtual reader: 


query rdr maint all @ 


The ALL operand requests a display of all 
information about the reader files. 


Chapter 2. Installing VM/XA SP with the Starter System (First Level) 49 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT nonn * PUN nnnnnnnn 001 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 

Ready; T=n.nn/n.nn hh:mm:ss 
This is the file you will IPL in substep 8 below. It 
has approximately 28,000 records. The exact size 
varies according to the system default language, 
local modifications, and VMSUP level. 


5. Order your reader so that the CMS nucleus will be processed first: 


order rdr fileno fileno is the file number of the CMS nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Ensure that the virtual reader is readied for class * reader files: 


query virtual 00c @ 

RDR O00C CL cl NOCONT NOHOLD EOF READY 
Q00C 2540 CLOSED NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 


7. If the virtual reader is not class *, issue: 


spool rdr class * keep The KEEP option places the spool file in USER 
Ready; T=n.nn/n.nn hh:mm:ss HOLD status after it has been read. To remove 
this file from your reader, issue purge rdr fileno, 
where fileno is the file number of the reader file. 


8. Load (IPL) MAINT’s virtual reader: 


ip] 00c clear @ 
HCPLDR8015I POSSIBLE OVERLAY: .SLC 000000 You may receive this message. It can be ignored. 


CMS Nucleus Generation Prompts and Responses | 


Note: Each of the following prompts appears only if the corresponding statement in DMSNGP is 
missing or empty (and the DEFNUC macro contains no default value), or if the DMSNGP 
statement contains a question mark (?): 


DMSINQ606R System disk address = 


a 190 is the default. 
DMSINQ615R Y-disk address = 

a 19E 1s the default. 
DMSINQ640R HELP disk address = 

a 19D is the default. 


DMSINQ764R Language id = 


Mor laongid @ This response identifies the /angid of your system 
national language. The default Jangid is AMENG 
(mixed-case American English). 
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DMSINQ293R Is this a DBCS language? Enter 1 (YES) or 0 (NO). 


0 Hf 


DMSINQ295R Language level id = 
E 


The default is 0 (NO); mixed-case American 
English is not a DBCS (Double-Byte Character 
Set) language. 


The system national language does not use a level 
ID. 


DMSINQ296R Should the installation segment be used? Enter 1 (YES) or 0 (NO). 


@ (orl @) ord 


DMSINQ310R Installation segment name = 


WM or segname @ 


DMSINI729R Do you want to save the system? 


0 


DMSINI730R Saved system name = 


M or sysname @ 


Enter 


DMSINI607R Rewrite the nucleus? Enter 1 (YES) or 


1 @ 


DMSINI608R IPL device address = 
| 
DMSINI609R Nucleus (CYL or BLK) address 


nnn 


The installation segment 1s an optional shared 
saved segment, into which you can place 
frequently used EXECs and System Product 
Editor (XEDIT) macros. You install the segment 
after you install your base system, but you must 
indicate now whether or not you are going to use 
it. 

The default is | (YES). Enter 0 if you do not 
want to use the segment. 


This prompt appears only if you accepted the 
default (or entered 1) at the previous prompt. 


Enter a 1- to 8-alphanumeric-character name for 
the installation segment, or press ENTER to 
accept the default name, CMSINST. 


1 (YES) or 0 (NO). 
Answer 0 (NO). You will save CMS in Step 27. 


The default is 1 (YES). Warning: The default 
response to this prompt does not agree with the 
sample DMSNGP file, where SAVESYS = NO. 


You will not see this prompt if you answered 0 to 
the preceding prompt. 


The default system names are CMS and CMSXA. 
Q (NO). 


Enter 1 to write the CMS nucleus on the disk that 
you specify in your response to the next prompt. 


The default is the address of the system disk (190). 


nnn is the location on the 190 system disk where 
the new CMS nucleus is written. Enter the correct 
cylinder address for your DASD type: 


Device Cylinder Address 


3350 068 
3375 105 
3380 066 
3390 062 
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DMSINI610R Also IPL CYL/BLK 0? Enter 1 (YES) or 0 (NO). 


1 of Enter 1 to wnte the initial IPL text on 
cylinder/block 0 of the disk where the CMS 
nucleus is written. 


The initial IPL text is a bootstrap program that 
reads the CMS nucleus from the cylinder/block 
where the nucleus is written (as defined in your 
response to prompt DMSINI609R). The initial 
IPL text is always written on the same 
cylinder/block as the nucleus. If the initial IPL 
text is not also written on cylinder/block 0, you 
must specify the cylinder/block address of the 
nucleus when you issue IPL commands for this 
system. For more information, refer to the 
description of the IPL command in VM/XA SP 
CP Command Reference. 


DMSINI611R Enter version identification: The version identification is displayed each time 
that you IPL the CMS system you are now 
generating. 

M or version You can enter up to 32 descriptive characters to 


identify this version and level of CMS, or you can 
press ENTER to accept the default version 
identification, VM/XA CMS 5.6 mm/dd/yy hh:mm. 


DMSINQ612R Enter installation heading: The installation heading appears at the beginning 
of each output file created using this CMS 
nucleus. 

M or heading & You can enter up to 64 descriptive characters to 


serve as an installation heading, or you can press 
ENTER to accept the default heading, VM/XA 
CONVERSATIONAL MONITOR SYSTEM. 


PO End of CMS Nucleus Generation Prompts and Responses Td 


DMSINS327I The installation saved segment could not be loaded 


Informational message: The CMSINST 
installation segment is not loaded and saved until 
you complete Step 27 on page 91. 


VM/XA CMS 5.6 mm/dd/yy hh:mm This is the default version identification. If you 
a defined your own version identification, it appears 
here and each time that you IPL 190 or IPL CMS. 


SYNONYM SYN 
CP TERM MODE VM 


Ready; T=n.nn/n.nn hh:mm:ss 
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Step 16. Save and Print the CMS Load Map 


In this step, you will: 
e Save a load map of CMS on the CMS LOCAL] disk 


e Print a copy of the load map. 


This step takes approximately 5 minutes. 


I. 


bo 


The CMS load map has been spooled to MAINT’s virtual printer. Ready the printer to send the CMS 
load map to MAINT’s virtual reader: 


spool prt * nohold @ 
Ready; T=n.nn/n.nn hh:mm:ss 
close prt * # 


RDR FILE fileno SENT FROM MAINT The CMS load map has been sent to MAINT’s 
PRT AS fileno RECS nnnn COPY 001 A NOHOLD NOKEEP virtual reader. If you do not get this message, it 
has already been sent there by a previous IPL 190. 


. Identify the reader file: 


query rdr * all @ 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 
MAINT  fileno M PUN nannnnnn 001 NONE mn/dd hh:mn:ss SYSPROG 


The CMS load map is the file with a blank 
filename and filetype. It has approximately 8,300 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUP level. Note the fileno of this file. You 
will use it in your next command. 


. Bring in the file from the virtual reader to the CMS LOCALI disk: 
access 395 d @ The CMS map 1s loaded on the CMS LOCAL] 
Ready; T=n.nn/n.nn hh:mm:ss disk. 


receive fileno fn ft d @ 
File fn ft D received from MAINT at * sent as (none) (none) D 
Ready; T=n.nn/n.nn hh:mm:ss 


You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap )jmdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as 1 —9, A, B, ©), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 
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. To print a copy of the CMS load map, issue: 


spool 00e to system class a @ 
Ready; T=n.nn/n.nn hh:mm:ss 
print fn ft d 

Ready; T=n.nn/n.nn hh:mm:ss 


. Examine the load map for errors: 


xedit fn ft Hf 


qquit @ 


. Continue with the next step. 
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Step 17. Tailor the Sample HCPRIO, HCPSYS, HCPBOX Files and 
the Product Parameter File 


In this step, you will: 
Edit the real I/O configuration and system definition sample files 


Tailor the HCPBOX sample file if you wish to change either the default logo that appears on your 
screen when you log on the system or the default logo that appears on separator pages 


Tailor the product parameter file only if you have a reason for changing the supplied CP nucleus 
generation information | 


e Assemble the real I/O configuration file and the system definition files. 


The time to perform this step varies depending upon the time you spend editing files. 


Overview 


Note: If you are applying updates with AUX files, follow the service procedures in Part 2, “Servicing the 
System.” 


As shipped on the product tape, the product parameter file and the sample files contain sample information 
and default parameters. Based on the requirements that were established in pre-installation planning, you 
must examine and modify these files to define your unique system configuration. 


The product parameter file, 56643089 S$PPF, contains information that the system generation tool (VMFBLD 
EXEC) uses when building system nuclei. 


The sample files, which you loaded from the product tape to MAINT 295 in “Step 5. Invoke the ITASK 
EXEC” on page 25, contain the following information: 


¢ The real I/O configuration file (HCPRIO ASSEMBLE) defines the configuration of your system 
input/output devices. 

e The CP system control file (HCPSYS ASSEMBLE) describes the system residence device (XASRES) and 
various system parameters. 

¢ The HCPBOX ASSEMBLE file defines both the logo that appears on your screen when you log on your 
system and the logo that appears on separator pages. 


Note: You may find it useful to print copies of the system files for future reference. These include HCPSYS 
ASSEMBLE, HCPRIO ASSEMBLE, and your user directory (default USER DIRECT). 


To tailor any of these files, use the VM/SP System Product Editor (XEDIT). XEDIT offers full-screen 
editing on display terminals. 


Note: When you XEDIT ASSEMBLE files, issue SET TRUNC 72 so that you do not lose the continuation 
character in column 72. 
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Procedure 


he 


Access 295 as D: 


access 295 d # 
Ready; T=n.nn/n.nn hh:mm:ss 


See Appendix C, “VM/XA System Product Starter System Information” on page 725 for the sample files 
that correspond to your VM/XA System Product starter system, and “A Sample Product Parameter File” 
on page 384 for a sample product parameter file. Unless you alter them, the ITASK EXEC will use 
these files as they appear in Appendix C, “VM/XA System Product Starter System Information” when it 
creates the new CP nucleus. If you wish to alter the real I/O configuration file, the system definition 
files, or the product parameter file, follow the instructions in this step. 


HCPBOX ASSEMBLE 


If you want to change the design or contents of either the logo that appears when you log on to the system, 
or the logo that appears on separator pages, tailor the sample HCPBOX ASSEMBLE file. Do not edit 
HCPBOX ASSEMBLE. IBM services this file and bases the service on the version supplied. Use the 
procedure for local modifications. 


l. 
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Establish the appropriate minidisk access order: 


Note: When you run VMFSETUP during the install procedures, it leaves the file 56643089 $SETUP on 
your A-disk. If VMFSETUP is run while this file exists on your A-disk, you receive a return code 
of 4 and a DMSWSU1900W message. You may want to erase 56643089 $SETUP after running 
VMFSETUP. 


vmfsetup 56643089 cp (all Mf 
erase 56643089 $setup a Mf 


. Verify that HCPXA CNTRL lists an auxiliary control file for local changes: 


xedit hcpxa cntrl & 
TEXT MACS HCPGPI HCPPSI HCPOM1 HCPOM2 CPLIB DMSGPI DMSOM OSMACRO 
PAT AUXPAT TX$ * LOCAL PATCHES 


LCL AUXLCL LCL * LOCAL MODIFICATIONS 

TEXT AUXXA i 

qquit @ HCPXA CNTRL should have a line like this one. 
The second field is the filetype of the auxiliary 
control file that points to local modifications. 


. Edit the auxiliary control file: 


xedit hcpbox auxlcl 


input You will add your local modifications at the top 
of the file. 
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ROOBOLLC LCL LCO@001 *UPDATE HCPBOX LOGO @ 


Bs 
file== fm = 


. Create the update file and apply the updates: 


xedit hcpbox assemble (ctl hcpxa @ 
DMSXUP178I Applying HCPBOX AnnnnnHP 
DMSXUP180W Missing PTF file HCPBOX ROQOOI1LC F5 


HCPBOX ROOOOILC Al 


===> 


set serial off Hf 
set trunc 72 


file = = fm @ 


In this example. ROOQOOILC is the filetype of the 
update file, and LC00001 is the local tracking 
number. The rest of the line, beginning with the 
asterisk (*), is a comment explaining the purpose 
of this modification. The text deck created when 
you assemble HCPBOX with your local 
modifications will be called HCPBOX LCLO0001. 


Press ENTER to return to the command line. 


fm is the CP LOCAL] disk (295). 


Instead of editing HCPBOX ASSEMBLE directly, 
you will apply changes to a copy of It. 


The updates supplied by IBM for HCPBOX 
ASSEMBLE are being applied. 


Your update file cannot be found because you 
have not created it yet. 


The system copies the source file and allows you 
to edit the copy. 


You want the source file’s sequence numbers and 
continuation characters to remain unchanged. 


Make your changes and file the update file on the 
CP LOCALI (295) disk. 


HCPRIO ASSEMBLE 


You can use a procedure similar to the one shown for updating HCPBOX ASSEMBLE to update HCPRIO 
ASSEMBLE, or you can use the procedure shown below. 


1. Edit the real I/O configuration source file. This file is on MAINT’s 295 minidisk. The file is called 
HCPRIO ASSEMBLE. 


Use the XEDIT command to edit the file. See the VM/XA SP System Product Editor User's Guide for 
information about the System Product Editor. 


You must make sure that your system volumes and consoles are defined properly in HCPRIO. If they 
are not, you will not be able to IPL your new system. 


For the real I/O configuration file, you may want to: 


e Delete those RDEVICE macro instructions for device numbers that the system will not be likely to 
use 


e Add RDEVICE macro instructions for device numbers that do not appear in the sample file. 
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Tailor HCPRIO ASSEMBLE to match the IOCDS, which is the data set that defines the I/O 


configuration for the hardware. See “System Installation on 308x, 4381, and 3090 Processor Complexes” 
on page 5. 


Note: When tailoring HCPRIO, minidisk caching is not allowed for shared DASD. To control sharing 
on a device level, use the RDEVICE SHARED= YES option in HCPRIO or use the SET 
SHARED ON FOR rdev command. These will effectively turn off minidisk caching on a device 
basis. We recommend that you set the RDEVICE macro in HCPRIO rather than using the SET 
SHARED ON FOR rdev command. | 


See VM/XA SP Planning and Administration for details about HCPRIO macro instructions and for a 
high-level explanation of HCPRIO ASSEMBLE. 


. File the edited version of the real I/O configuration file on MAINT’s 295 minidisk. Use the XEDIT 


subcommand FILE. 


HCPSYS ASSEMBLE 


You can use a procedure similar to the one shown for updating HCPBOX ASSEMBLE to update HCPSYS 
ASSEMBLE, or you can use the procedure shown below. 


1. Edit the system definition source file. The file, called HCPSYS ASSEMBLE, is on MAINT’s 295 


minidisk. 
Use the XEDIT command to edit the file. See the VM/XA SP System Product Editor User's Guide for 
information about the System Product Editor. 
For the system definition file, you may want to: 
e¢ Change the device number for the system residence device on the SYSRES macro instruction. 


Note: By convention, IBM assigns device number 0123 for the system residence device. This device 
number appears in four places: 


— Qn the DIRECTORY control statement in the user directory. 


— Onan MDISK control statement in MAINT’s entry in the user directory (this gives 
MAINT read/write access to the system residence device). 


— On the SYSRES macro instruction. 


~ In the product parameter file. (The device number for the system residence device might 
not be included in the product parameter file [56643089 $PPF].) 


If you change the device number in one place, be sure to make an identical change in the 
other three places. 


¢ Modify the SYSSTORE macro instruction. Set the RMSIZE operand to the storage of your 
processor. If your system will have a virtual=real area (including storage for virtual = fixed guests), 
set the VRSIZE operand. If any virtual machines will need to issue DIAGNOSE X'98' in 
System/370* mode, or in 370-XA mode with 24-bit addressing, set the RIO370 operand. 


¢ Modify the SYSTIME macro instruction for your time zone. 


System/370 is a trademark of the IBM Corporation. 
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¢ Tailor the volume identifiers on the SYSCPVOL and SYSUVOL macro instructions to match the 
volume identifiers your system will use. Because this action eliminates extraneous warning messages. 
the action helps the real system operator identify volumes that are not mounted at IPL time. 


e Supply your own system identifier on the SYSID macro instruction. 


See VM/XA SP Release Guide for Release 2.1 for details on HCPSYS macro instructions. 


2. File the edited version of the system definition file on MAINT’s 295 minidisk. Use the XEDIT 


subcommand FILE. 


56643089 $PPF 
1. The default 56643089 $PPF should be appropriate for most installations, but if your experience suggests 


changes, you can override 56643089 $PPF. 
DO NOT alter this file unless you have a special need. 


The best way to change the product parameter file is to create an override file. For a discussion of 
override files, see “The Product Parameter Override File” on page 402. 


Use the XEDIT command to create an override file on the TASK (5E5) minidisk. See the VM/XA SP 
System Product Editor User’s Guide for information about the System Product Editor. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


2. File the override file on the TASK (SE5) minidisk. Use the XEDIT subcommand FILE. 


Assemble the Files 
1. Assemble the HCPRIO, HCPSYS, and HCPBOX ASSEMBLE files: 


itask assemble filename Hi If an error occurs while assembling any of the 
system definition files, see “Correcting Assembly 
DMSWHM1907I Assembling filename Errors” on page 60. 

DMSUPD178I Updating HCPBOX ASSEMBLE B1 You will see these messages only when you 
DMSUPD178I Applying HCPBOX AnnnnnHP F5 assemble HCPBOX ASSEMBLE, and only if you 
DMSUPD178I Applying HCPBOX ft B5 updated it. 


DMSWHM1909I filename {TEXT|ft} A created 

RDR FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP © 

Ready; T=n.nn/n.nn hh:mm:ss 


. Copy these text files from your A-disk to the CP LOCAL] (295) minidisk: 


HCPSYS ft 
HCPRIO ft 
HCPBOX ft 


copy filename {text|ft} a = = fm (replace Mf fm is the CP LOCAL! minidisk (295). 
Ready; T=n.nn/n.nn hh:mm:ss 

erase filename {text|ft} a M@ 

Ready; T=n.nn/n.nn hh:mm:ss 
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Correcting Assembly Errors 


To correct assembly errors in system definition ASSEMBLE files, do the following: 
1. Examine the flagged statements. See VM/XA SP Planning and Administration for directions on coding. 


2. Correct the statements causing an error by editing the system definition file with the System Product 
Editor (XEDIT). 


3. Reassemble the system definition file in which the change was made using the procedure in “Assemble the 
Files” on page 59. 


4. Repeat the sequence until all files assemble correctly. 
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Step 18. Generate the New CP Nucleus 


In this step, you will use the ITASK EXEC to build your new CP nucleus. 


This step takes approximately 20 minutes. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


1. Purge all unnecessary files from your reader to increase available spool space. 


2. Spool punch output to your own virtual reader: 


spool punch * @ 
Ready; T=n.nn/n.nn hh:mm:ss 


3. Invoke the ITASK EXEC to build the CP nucleus. 


Note: Before you issue ITASK BUILD, ensure that you are running in 370 mode by doing the 
following: 


set machine 370 
SYSTEM RESET 
SYSTEM = 370 


Now continue with the substep: 


itask build cp noassem Use the noassem only if you have already 
assembled HCPSYS ASSEMBLE, HCPRIO 
ASSEMBLE, and HCPBOX ASSEMBLE. If you 
have not assembled these files, you must omit the 
noassem operand, so that ITASK will assemble 
them now. 


If you assemble the files here, copy the text decks 
from MAINT 191 to the CP LOCAL]! minidisk 
(295), then erase them on MAINT 191. 


nonnnnnn FILES CHANGED The CP nucleus is being created. It will be sent to 
DMSACC724I 191 replaces A(191) your reader. 
LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


RDR FILE fileno TO MAINT COPY 001 NOHOLD 


Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be that a 
PTF which is now being applied has another PTF, 
outside CP, as a prerequisite. Check the 
S$VMFBLD $ERRLOG file for message 
DMSBNC1854W. 
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4. Review the build exception log ($VMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build @ 


5. Ensure that the proper files are in MAINT’s virtual reader: 


query rdr maint all @ The ALL operand requests a display of all 
information about the reader files. 

ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT = nnnn * PUN nnnnnnnn 001 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 


Ready; T=n.nn/n.nn hh:mm:ss 
This is the file that you will IPL in substep 10 on 
page 63 below. It has approximately 75,000 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUP level. 


6. Order your reader so that the CP nucleus will be processed first: 


order rdr fileno @ fileno is the file number of the CP nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


7. Ensure that the virtual reader is readied for class * reader files: 


query virtual 00c @ 

RDR Q00C CL cl NOCONT NOHOLD' EOF READY 
Q00C 2540 CLOSED NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 


8. If the virtual reader is not class *, issue: 


spool rdr class * keep The KEEP option places the spool file in USER 
Ready; T=n.nn/n.nn hh:mm:ss HOLD status after it has been read. To remove 
this file from your reader, issue purge rdr fileno, 
where fileno is the file number of the reader file. 


9. If necessary, redefine your virtual storage. First, find out how much virtual storage MAINT has: 


query virtual storage Mf 
STORAGE = nnnnM 
Ready; T=n.nn/n.nn hh:mm:ss 


Now determine how much storage you need: 
¢ You need at least 16 megabytes to IPL your virtual reader in substep 10 on page 63. 


¢ If you are generating a CP nucleus with a preferred virtual machine, MAINT’s virtual storage must 
be at least 4 megabytes greater than the sum of the VRSIZE, VRFREE, and RIO370 operands in the 
SYSSTORE macro instruction in HCPSYS ASSEMBLE. For more information on the SYSSTORE 
macro instruction, refer to VM/XA SP Planning and Administration. 


If MAINT’s virtual storage must be set to a value greater than 32MB (the maximum size for 
MAINT as defined by the sample USER DIRECT file), then you must tailor the directory to change 
the maximum virtual machine size for MAINT. Once the directory is changed, bring it online by 
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10. 


issuing DIRECTXA directory-name. If this is not done, you will receive wait state 8028 when the 
reader is IPLed. 


If you need to increase your storage to more than 16 megabytes, first issue: 


set machine xa @ Storage addresses greater than 16M require 
SYSTEM RESET 370-XA architecture. If your machine ts already 
SYSTEM = XA in 370-XA mode, you will not get a response. 


If you need to increase your storage (even if you need only 16M), issue: 
define storage nnnnm & 


STORAGE = nnnnM 
STORAGE CLEARED - SYSTEM RESET 


Load (IPL) MAINT’s virtual reader: 


ip] 00c clear @ 


hh:mm:ss * MSG FROM MAINT — : The 9010 disabled wait state indicates that the CP 
HCPGENSQ10W NUCLEUS LOADED ON XASRES nucleus was successfully loaded on the system 
HCPGIR450W CP ENTERED; DISABLED WAIT residence device. 


PSW Q00A0000 00009010 If you receive disabled wait state code 8028, see 


“Correcting IPL Errors.” 


If you receive a different disabled wait state code. 
see VM/XA SP System Messages and Codes 
Reference. 


. Issue the following commands to ensure that these settings are in effect: 


set machine 370 If your machine is already in 370 mode, or if your 
SYSTEM RESET storage is already 16M, you will not get a 
SYSTEM = 370 response. 


define storage l6ém Hf 
STORAGE = 0016M 
STORAGE CLEARED - SYSTEM RESET 


You have now loaded the CP nucleus. 


Correcting IPL Errors 


If you receive disabled wait state code 8028 when you try to IPL your reader, you must correct the problem 
as follows: 


l. 
2. 
oy 


Close the reader. Issue CLOSE RDR. 
Determine the reader file number of the IPL deck. Issue QUERY RDR ALL. 


Take the IPL deck out of USER HOLD status. Issue CHANGE RDR nannn NOHOLD, where nnnn is 
the reader file number of the IPL deck. If this step is not done, you will receive wait state 232 when the 
reader is re-IPLed. 


Tailor the directory (default USER DIRECT) as described in substep 9 on page 62. 
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| 


3, 
6. 


Reissue DIRECTXA directory-name. 
IPL the reader. Issue IPL C CLEAR. 


Correcting Load Errors 


If the new CP nucleus fails to load, do the following: 


l. 


to 
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IPL CMS: 


ip] 190 clear @ 
PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 
DMSWSP327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm If you have changed the version heading, your 
a own heading will appear. 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


Access 295, then inspect the CP load map and virtual PSW. An error in loading may show up in either 
the load map or in the PSW. 


For a list of loader wait-state codes, refer to VM/XA SP System Messages and Codes Reference. 
Correct the error. 


Go back to the point where the error may have occurred. If you cannot determine where the error may 
have occurred, see “Step 13. Install Assembler H Version 2 Program Product” on page 44. 
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Step 19. Save and Print the CP Load Map 


In this step, you will: 


e IPL CMS 
e Save the load map of the new CP system 
e Print a copy of the new CP load map. 


This step takes approximately 10 minutes. 


| 1. When you built CP, the CP load map was spooled to MAINT’s virtual printer. The load map must be 
| transferred to MAINT’s virtual reader. If you have IPLed 190 since building CP, the load map may 
| have already been spooled from the virtual printer to the virtual reader. 


| Query the printer to see if the load map 1s still there. If it is, note the file number. If it is not, skip 
| substep 3 and go to substep 2. 


| query prt all 

| OWNERID FILE CLASS RECORDS CPY HOLD DATE TIME DIST 

| MAINT fileno A PRT nnnnnnnn 001 NONE mm/dd hh:mm:ss SYSPROG 

| Ready; T=n.nn/n.nn hh:mm:ss The CP load map 1s the file with a blank filename 
| and filetype. It has approximately 30,000 records. 
| The exact size varies according to the system 

| default language, local modifications, and VMSUP 
| level. 


2. IPL CMS: 


ip! 190 clear @ 

DMSWSP327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

B 


SYNONYM SYN 


CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 


| CP Load Map in Virtual Printer Only | 


3. Transfer the printer file to your reader: 


| transfer prt fileno * rdr @ 

| RDR FILE fileno TRANSFERRED FROM * FILE fileno 
| Q001 FILE TRANSFERRED 

| Ready; T=n.nn/n.nn hh:mm:ss 


| PO End of CP Load Map in Virtual Printer Only ee ee, 
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4. Access the CP LOCALI disk: 


access 295 d # This is the disk on which you will receive the load 
Ready; T=n.nn/n.nn hh:mm:ss map. 


5. Identify the reader file: 


query rdr * all @ 


QORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST USERFORM OPERFORM KEEP MSG 
MAINT fileno A PUN nonnnnnn 001 NONE mm/dd hh:mm:ss SYSPROG STANDARD STANDARD OFF OFF 


The CP load map is the file with a blank filename 
and filetype. It has approximately 30,000 records. 
The exact size varies according to the system 
default language, local modifications, and VMSUP 
level. 


Note the fileno of this file. You will use it in your 
next command. 


6. Bring in the file from the reader to the CP LOCAL! disk: 


receive fileno fn ft d @ This command saves the load map on the CP 
fn ft Dl created LOCAL] (295) minidisk. 
DMSRDC738I Record length is 132 bytes 
File fn ft D received from MAINT at * 
sent as (none) (none) D 


You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as | —9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 
7. To print a copy of the load map for the CP nucleus, issue: 
spool @0c class a Mf 
Ready; T=n.nn/n.nn hh:mm:ss 


print fn ft d @ The load map is printed on your system printer. 
Ready; T=n.nn/n.nn hh:mm:ss 
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8. Examine the load map for errors: 


xedit fn ft 


9. Examine the load map for unresolved symbols. There should be no unresolved symbols. 


locate /unresol @ You are still in XEDIT mode. 


DMSXDC546E Target not found 
qquit & 
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Step 20. Load the New CP Nucleus 


In this step, you will: 


Shut down the VM/XA System Product starter system 
Perform a hardware initial program load of the new CP nucleus. 


This step takes approximately 10 minutes. 


1. Shut down the starter system you are now using. A class A user (usually the primary system operator) 


tO 
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must issue the SHUTDOWN command. 


shutdown 
SYSTEM SHUTDOWN COMPLETE 


IPL the real address of your system residence device. Follow the hardware operations guide for your 
processor. 


If you are unable to IPL your system residence device, go back to “Step 2. Restore the VM/XA System 
Product Starter System to Disk” on page 15 and continue from there. 


VM/XA SYSTEM PRODUCT RELEASE 21 SERVICE LEVEL 0000; 
SYSTEM NUCLEUS CREATED ON mm/dd/yy AT hh:mm:ss, 
LOADED FROM XASRES 


KKKKEKKKEKKEKRKEKRKREKKKKKKEEKRKREKEKKEKKKEKEREKKKEKKKE 


* LICENSED MATERIALS - PROPERTY OF IBM* * 


* 


+ 


* 5664-308 (C) COPYRIGHT IBM CORP. 1983, * 
* 1989. ALL RIGHTS RESERVED. ' 
* US GOVERNMENT USERS RESTRICTED RIGHTS - * 
* USE, DUPLICATION OR DISCLOSURE * 
* RESTRICTED BY GSA ADP SCHEDULE CONTRACT * 
* WITH IBM CORP. : 
* * 
* * TRADEMARK OF INTERNATIONAL BUSINESS  * 

* 


* MACHINES. 


REKKKKKKKKKKKKKKKKKKKKKRKKKK KKK KK KKK KKK KK KKK 


HCPISU9511 CP VOLID volid NOT MOUNTED 


Note: A 9025 disabled wait state indicates that your system volume (XASRES) is not defined in the 
HCPRIO ASSEMBLE file. A 1010 disabled wait state indicates that your console is not defined 
in the HCPRIO ASSEMBLE file. 


During the initialization phase, respond cold drain to the START message: 


START ((COLD|WARM|FORCE) (DRAIN) (DISABLE) (NODIRECT) ) | (SHUTDOWN) 
cold drain @ 
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NOW hh:mm:ss EDT day mm/dd/yy 
CHANGE TOD CLOCK (YES|NO): 
no # 


The directory on volume XASRES at address nnnn 
has been brought online. 

There is no logmsg data 

FILES: NO RDR, NO PRT, NO PUN 

LOGON AT Ahsmm:ss EST day mm/dd/yy 


HCPCPJ951I CP volid volid not mounted 


You are now logged on to the OPERATOR user ID. 


STORAGE = 0016M 
FILES 0000001 RDR, Q0Q0001 PRT, NO PUN 


XAUTOLOG AUTOLOG1 

HCPAUTO53E AUTOLOG] not in CP directory 
XAUTOLOG EREP 

HCPAUTO53E EREP not in CP directory 
XAUTOLOG DISKACNT 

HCPAUTO53E DISKACNT not in CP directory 


Note: If the clock is not set, set the TOD clock 
using standard operating procedures. 
Consult VM/XA SP Real System Operation 
for those procedures. 


volid is a DASD volume listed on the SYSCPVOL 
macro instruction of HCPSYS. If the volume is 
not one that you are using, ignore the message. 


After you have modified the user directory, these 
error messages will no longer appear. 


. Define the storage that you want for the OPERATOR user ID: 


define storage l6m & 
STORAGE = 0016M 
STORAGE CLEARED - SYSTEM RESET 


. Enable the devices in your revised HCPRIO file: 
enable all @ 


hh:mm:ss Command complete 
terminal mode vm @ 


. IPL 190: 


ip] 196 clear Mf 


This is an example. You may define more than 
16M. 


DMSWSP327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm 
io 


DMSACP1123E A(191) device error 
Ready; T=n.nn/n.nn hh:mm:ss 


If you see this error message, you have not 
formatted the operator’s 191 minidisk. 
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7. Format the operator’s 191 minidisk only if you have not already done so: 


format 191 a @ 

DMSFOR603R FORMAT will erase all files on disk A(191). 
Do you wish to continue? 
Enter 1 (YES) or © (NO). 

1 ow 

DMSFOR605R Enter disk label: 

opri91 

DMSFOR733I Formatting disk A 

DMSFOR732I n cylinders formatted on A(191) 

Ready; T=n.nn/n.nn hh:mm:ss 


8. Disconnect from OPERATOR and log on as MAINT. 
Note: If you do not have XAPOO01, you will receive this message: 
HCPLND1O8E MAINT 0124 NOT LINKED 
when you log on as MAINT. If you are using 3380 or 3390 DASD, you can ignore this message. 


70 Installation and Service 


Step 21. Update the User Directory 


In this step, you will: 


e Edit the sample user directory 
e Use the DIRECTXA command to update the user directory. 


The time to perform this step varies depending on the time you take to edit files. 


1. See Appendix C, “VM/XA System Product Starter System Information” on page 725 for sample user 
directories. 


Note: All logon passwords are NOLOG and there are no MDISK passwords, except for some of 
MAINT’s minidisks. You may want to change these. 


2. Edit the sample user directory (USER DIRECT on MAINT’s 295 minidisk): 


access 295 d Hf 
xedit user direct 


Be sure to change the logon passwords in USER DIRECT from NOLOG to your own non-restricted 
installation passwords. (For a list of restricted passwords, see Appendix F, “Restricted Logon 
Passwords” on page 859.) Also, be sure to change the logon password you provided for the MAINT 
and OPERATOR virtual machines in “Step 5. Invoke the ITASK EXEC” on page 25. This password 
appeared in the console file. 


Also, take this opportunity to add or change MDISK passwords for the MDISKs defined in USER 
DIRECT. 


Note: The read, write, and multiple-write passwords are positional. Refer to the skeletal MDISK 
statement provided in USER DIRECT. If you will be starting accounting and error recording 
later, this is a good time to add or change MDISK passwords for the DISKACNT and EREP 191 
minidisks. 
For more information about the user directory, see VM/XA SP Planning and Administration. 
3. When your changes are complete, enter file on the command line. 


4. Use the DIRECTXA command to update and place the user directory online: 


directxa user direct @ 

VM/XA SYSTEM PRODUCT USER DIRECTORY CREATION PROGRAM - RELEASE 2.1 
EOJ DIRECTORY UPDATED AND ON LINE 

Ready; T=n.nn/n.nn hh:mm:ss 
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Step 22. ITASK Loads HELP Files from the Product Tape (Volume 2) 


In this step, the ITASK EXEC loads HELP files from Volume 2 of the product tape. 


The time this step takes varies from system to system, but a good estimate is 40 minutes. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If If you change an address 
in any one of these places, you must change it in all of them. We recommend that you do not change 
any addresses. 


1. Attach your tape device as 181 and mount Volume 2 of the product tape on It. 
Follow the operation manual for the machine on which you mount the tape. 


2. Enter the ITASK command with the LOAD AMENGHLP, LOAD UCENGHLP, or LOAD HELP 
operands to load the HELP files. Should a problem occur during this step, or for some reason you want 
to return to this step and load these tape files, you can invoke the load function by entering the ITASK 
command again. 


itask load {amenghIp|ucenghIp|help! The HELP files on the tape are in mixed-case 
American English: 


¢ Use the amenghlp operand to load the HELP 
files to the 19D disk. 


¢ Use the ucenghlp operand to load the HELP 
files directly to the 19C disk, then convert 
them to uppercase. Conversion takes about 
20 minutes. 


¢ Use the help operand to load the HELP files 
to the 19D disk, then copy them to the 19C 
disk and convert the copied files to uppercase. 


DMSWSL409I Loading AMENGHLP FILES to the You will see this message if you used the amenghlp 
19D disk attached to MAINT or help operand. 

DMSWSL409I Loading UCENGHLP FILES to the You will see this message if you used the ucenghlp 
19C disk attached to MAINT operand. 

CONVERTING HELP FILES TO UPPERCASE You will see this message if you used the ucenghlp 

Ready; T=n.nn/n.nn hh:mm:ss or help operand. 


72 Installation and Service 


Step 23. ITASK Loads Source Files from the Product Tape (Volume 


3) 


In this step, the ITASK EXEC loads CP, CMS, and dump viewing facility source files from Volume 3 of 


the product tape. 


The time this step takes varies from system to system, but a good estimate is 30 minutes. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


1. Attach your tape device as 181 and mount Volume 3 of the product tape on it. 


Follow the operation manual for the machine on which you mount the tape. 


2. Enter the ITASK command with the LOAD ALL3 operands to load all the source files. Should a 
problem occur during this step, or for some reason you want to return to this step and load these tape 
files, you can invoke the load function by entering the ITASK LOAD ALL3 command again. 


itask load all3 @ 


DMSWSL409I Loading CP SOURCE to the 

394 disk attached to MAINT 
DMSWSL409I Loading CMS SOURCE to the 

393 disk attached to MAINT 
DMSWSL409I Loading DUMPVIEW SOURCE to the 

393 disk attached to MAINT 


Ready; T=n.nn/n.nn hh:mm:ss 


| Note: Source files are not unpacked during the load. 


These are messages from ITASK as it loads files 
from the product tape. 


ITASK has finished restoring source files from 
Volume 3 of the product tape. 
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Step 24. Install Environmental Record Editing and Printing 


In this step, you will: 


e Read the documentation for the Environmental Record Editing and Printing (EREP) Program 
e Follow the directions to install EREP. 


The time to perform this step may vary, but a good estimate is 15 minutes. 


Note: IBM packages the Environmental Record Editing and Printing (EREP) Program, VM Feature, 
5654-260, as a separate program product. This program product has its own installation procedure. 


1. Read the documentation for EREP: 
e¢ The following memos in tape files 1 and 2 of the VMSUP EREP tape: 


— 53654260B MEMO 

— F5654260 MEMO2 
— [15654260 MEMO 

— 5654260B SERVICE 


e The Program Directory for EREP, which describes the installation procedure for EREP. 
Note: This document does not come with the VMSUP tape. You must order it separately. 
e The discussion of EREP in VM/XA SP Planning and Administration. 
2. Follow the directions in the EREP Program Directory to install EREP from the VMSUP EREFP tape. 
Note: You will receive messages HCPCRC8059I and HCPCRC8060I until EREP is installed. 
3. IPL 190: 


ip! 190 clear @ 
DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 


a Press ENTER to complete CMS initialization. 
SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 
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Step 25. Install the Printer Image Library 


In this step, you will install the image library for your printer and save it on tape. 


This step takes approximately 10 minutes. 


Warning: Do not attach the tape unit to MAINT. SPTAPE will attach it. If you have any other tape 
unit attached, detach it. 


1. Load (IPL) 190. This is the CMS system disk. 


ip! 198 clear @ 
DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 


a Press ENTER to complete CMS initialization. 
SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


2. Establish the correct minidisk access order: 


Note: When you run VMFSETUP during the install procedures, it leaves the file 56643089 $SETUP on 
your A-disk. If VMFSETUP is run while this file exists on your A-disk, you receive a return code 
of 4 and a DMSWSU1900W message. You may want to erase 56643089 $SETUP after running 
VMFSETUP. 


access 565 b @ 

vmfsetup 56643089 cp Mf 
Ready; T=n.nn/n.nn hh:mm:ss 
erase 56643089 $setup a @ 
Ready; T=n.nn/n.nn hh:mm:ss 


3. Invoke the IMAGELIB command. The command requires the filename of the image library (fn 
CNTRL). IBM supplies default image library control files called IMAGxxxx CNTRL, where xxxx is 
the printer number: 3800, 1403, 3203, 3211, 3262, 4245, or 4248. 


For more information about image libraries, see VM/XA SP Planning and Administration. 


imagelib libname @ If you use the IBM-supplied image library, 
HCPNMT247I NAMED IMAGE IMAGxxxx CREATED libname is IMAGxxxx, where xxxx is the printer 
Ready; T=n.nn/n.nn hh:mm:ss number. 
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4. 


76 


Check the status of the image library: 


query img all @ 
OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*IMG nonn IMG A nnnn mm/dd hh:mm:ss fn IMG MAINT 


Check the current state of the file (CL), the 
filename, and filetype. 


Issue the appropriate LOADBUF command and start the printer. See VM/XA SP CP Command 

Reference for more information. 

Mount a scratch tape with ring on an available 3420, 3422, or 3430 tape drive, or insert a cartridge into 

an available 3480 unit, with the thumbwheel turned until the white dot is not visible. Follow machine 

operations manuals to mount the tape. 

¢ Do not attach the tape unit to MAINT. SPTAPE will attach it. If you have any other tape unit 
attached, detach It. 
e The tape is suitable for a 3420, 3422, 3430, or 3480 tape unit. 
Note: This procedure assumes the tape mode is 1600 bits per inch. 
. Issue the SPTAPE command to dump the image library to tape: 

sptape dump rdevno img all run @ Substitute the real device number of the tape drive 
for the value rdevno. The operand RUN specifies 
that SPTAPE rewinds and unloads the tape after 
the operation. 

DUMPING rdevno IMG *IMG nnonn A The message from SPTAPE tells you the file is 

: being dumped to tape. 

SPTAPE DUMP FUNCTION ON 

DRIVE rdevno COMPLETE 
Ready; T=n.nn/n.nn hh:mm:ss 
. Store the tape for emergency use. If it is ever necessary, you can use this tape and the SPTAPE LOAD 


181 IMG ALL RUN command to restore the image libraries. For more information about the SPTAPE 
command, see VM/XA SP Real System Operation. 


. If necessary, reattach your tape drive. 
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Step 26. Load, Build, and Save GCS 


You must install the GCS (group control system) component if you plan to install SNA products or RSCS 
Version 2. Before you begin, read “Planning for the Group Control System (GCS)” on page 9. 


If you do not want to install GCS, go to “Step 28. Install the CMSDOS, CMSBAM, CMSVSAM, and 
CMSAMS Saved Segments” on page 95. 


To install GCS, you will do the following steps: 
e Load GCS from Volume 2 of the product tape. 
¢ Invoke the GROUP EXEC and complete a series of panels to create a GCS configuration file. 


Note: If you do not have a full-screen display device, you cannot use the GROUP EXEC because 
you cannot display the panels. In that case, you must build the configuration file manually, 
using the build macros described in the VM/XA SP Group Control System Command and 
Macro Reference. 


After you complete the panels, you invoke the ITASK EXEC with the BUILD GCS parameters. 


ITASK: 


— Modifies a copy of the GCS loadlist (GCSLOAD EXEC) and changes the entry that contains the 
filename of the GCS configuration file (the default is GCS) to match the filename of the 
configuration file that you just created (the default is also GCS). 

Files the modified loadlist on the MAINT 295 minidisk. The modified loadlist is used during the 
generation of the GCS named saved system. 

Renames the filetype of the GCS configuration file from GROUP to ASSEMBLE. 

Invokes VMFHASM EXEC to assemble the configuration file. 

Invokes VMFBLD EXEC with the BUILD GCS parameters to build and save the GCS nucleus. 


After you build and save the nucleus, you can save and print the GCS load map, which contains the 
storage addresses of the nucleus control sections and entry points. 


If you want to install more than one GCS nucleus, you must re-access the GCS minidisk structure 
and re-invoke the GROUP EXEC to create another GCS configuration file. Each configuration file 
must have a unique name and have an entry in the SAMPNSS EXEC. 


This step takes approximately 30 minutes for each GCS system. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all the others. We recommend that you do not change any 
addresses. 


1. Attach a tape drive to MAINT. 
2. Mount Volume 2 of the product tape. 
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3. Issue ITASK LOAD GCS to load the GCS code: 


itask load gcs Mi 
DMSWSL409I LOADING GCS INTERFACE TO 
THE 190 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS OBJECT TO 
THE 595 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS PUTAPPLY TO 
THE 592 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS PUTDELTA TO 
THE 596 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS CORAPPLY TO 
THE 592 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS CORDELTA TO 
THE 596 DISK ATTACHED TO MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


4. IPL 190: 


ip] 190 clear @ 
DMSINS3271 The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 


a Press ENTER to complete CMS initialization. 
SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


5. Establish the correct minidisk order: 


access 5£5 b Hf 

vmfsetup 56643089 gcs (all @ 
Ready; T=n.nn/n.nn hh:mm:ss 
erase 56643089 $setup a @ 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Set up the GROUP EXEC messages in storage: 
Notes: 


a. If you are REBUILDING a GCS nucleus and your current configuration file does not require 
changes, you can skip this part of the step and go directly to the nucleus build operation on page 86. 


b. If you do not have a full-screen display device, you cannot use the GROUP EXEC to build the 
configuration file. Do not set up the GCS messages in storage. Instead, refer to the VM/XA SP 
Group Control System Command and Macro Reference and use the build macros described there to 
build the configuration file manually. Then continue this step with the nucleus build operation on 
page 86. 


copyfile csimes[y] [text|txtnnnnn]| fm csiume[y|text a Ml 

Ready; T=n.nn/n.nn hh:mm:ss y is the country code for your system default 
national language: blank for mixed-case American 
English and b for uppercase American English. 
You can use QUERY LANGLIST to determine 
your system default national language. 
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The CSIMES text file is shipped as TXTnnnnn. The most current version of this file can be determined 
by referring to the first entry in the CSIMES AUX file. In the first entry, there is a field that reads 
UMnonnnn, where nnnnn is the PTF number. 


Note: If you have not received service on the CSIMES text file, you do not have a CSIMES file with a 
filetype of TXTnnnnn. 


You will have one with a filetype of TEXT. 


This command creates a temporary GCS message file (containing the messages for the GROUP EXEC) 
that has the filename required by the SET LANGUAGE command. A permanent message file will be 
created when you generate the GCS nucleus. If there has been any service to the message file. the 
permanent file will reflect it. 


set language langid (add csi user Ml langid identifies your system default national 

Ready; T=n.nn/n.nn hh:mm:ss language. At this point, /angid will be either 
ameng (mixed-case American English) or uceng 
(uppercase American English). 


This command sets the language of the temporary 
GCS message tile and places the file in user 
storage. 


7. Invoke the GROUP EXEC to display the configuration panels. 


Use your installation reference worksheet to help you complete the panels. For more information, see 
“Planning for the Group Control System (GCS)” on page 9. 


group systemname @ This command assigns systemname as the filename 
of the GCS configuration file that you are creating 
and invokes the Primary Option Menu. The 
systenmame parameter is optional at this time. If 
specified, it must match the system name in the 
DEFSYS entry for this GCS system in the 
SAMPNSS EXEC (the sample system name Is 
GCS). If you specify a system name here, the 
Primary Option Menu appears with the system 
name filled in. If you do not specify a system 
name here, you must specify one on the Primary 
Option Menu. 
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Table 2. Function Keys Used with the GROUP EXEC Panels 
PFl HELP Shows information about the panel you are looking at. 
PF2 CLEAR Clears the input areas where you enter information. 

it, you receive the message: 

577E File has been changed; type QQUIT to quit 


PF3 END Leaves the present panel and returns you to a previous one. 
anyway 


¢ If you press PF3 on the primary option menu, you return to CMS. 

e If you press PF3 on any other screen, you return to the Primary Option 
Menu. 

e If you press PF3 after you have entered information, but have not saved 


PFS REFRESH Fills in the panel’s input areas with the values you last saved there. 


systemname GROUP). 


ENTER Processes any valid CP or CMS command typed on the command line. Two 


specific commands you can enter are: 


1, QQUIT, entered from the primary option menu, returns you to CMS. If 
entered on any other panel, it returns you to the Primary Option Menu. 
2. CANCEL, entered on any panel, returns you to CMS. 
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GCS GROUP - PRIMARY OPTION MENU Primary 


Fill in the blanks with the required information and then press the ENTER key. 


Type/change the name of the saved system that is being defined. 
SYSTEM NAME : 
Type one number from the list below to display/update the: 
1. Authorized VM Userids. 
2. Saved System Information. 


3. Saved Segment Links. 


Type your choice here: _ 


PF: 1 HELP 2 CLEAR 3 END ‘ rr O sce 
PFs 7 ace SB: “Aves 9 VERIFY 10 ... we 12 CURSOR 


s=s> 


8. To complete the Primary Option Menu: 
a. Fill in or change the SYSTEM NAME. 


If you invoked GROUP with the systemname parameter, this panel appears with the SYSTEM 
NAME already fiiled in. 


b. Select the next panel (1, 2, or 3) and press ENTER. 


The first time you leave the Primary Option Menu, select panel 1; the next time, panel 2; the third 
time, panel 3. 


Chapter 2. Installing VM/XA SP with the Starter System (First Level) 81 


AUTHORIZED VM USERIDS FOR < PAGE 1 OF 1 


To ADD, fill in the blanks with the authorized VM userids. 
To CHANGE, type a new userid over the userid to be changed. 
To DELETE, type blanks on the line. 


Pressing the ENTER key or PF6 key will save the update. 


PF: 1 HELP 2 CLEAR 3 END ° 5 REFRESH 6 SAVE 
PFs: 7 PREVIOUS 8 NEXT 9 VERIFY 10 ... ll... 12 CURSOR 


p+ — 5 —f— Se 


9. To complete the Authorized Userids panel: 
a. Type in the user IDs. 


Press ENTER or PF6 after typing the user IDs to save your information. Every time you press 
ENTER or PF6, the GROUP EXEC tells you how many user IDs it has processed. Use PF7 and 
PF8 if you have more than one screenful of user IDs. 


b. Return to the Primary Option Menu. 


Press PF3. If you forget to press ENTER or PF6, you will remain on this screen and see the 
message: 


577E File has been changed; type QQUIT to quit anyway 


To continue, simply press PF6. You will receive a message telling you how many authorized user 
IDs the EXEC has processed. Press PF3 again to return to the Primary Option Menu. 
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GRP121 PAGE 1 OF 2 


To ADD, fill in the blanks with the information. 
To CHANGE, type the information over the displayed value. 
To DELETE, type blanks on the line. 


Pressing the ENTER key or PF6 key will save the update. 


SYSTEM DISK address (S-disk) : 
SYSTEM DISK EXTENSION address (Y-disk): 59E 


USERID to RECEIVE STORAGE DUMPS. . . .: 
RECOVERY MACHINE USERID (required) . .: 


GCS TRACE TABLE SIZE (minimum 4K). . .: 


PF: 1 HELP 2 CLEAR 3 END as 5 REFRESH 6 SAVE 
PRE 2 asc 8 NEXT 9 VERIFY 10 ... 4 re 12 CURSOR 


SS >: 


10. To complete the first Saved System Information panel: 
a. Specify your disk addresses. 


The default 595 and 59E virtual addresses are already saved and verified. If you must choose 
different addresses, type over the default values. 


Note: Make sure the new information is correct; the GROUP EXEC does not prevent you from 
saving invalid information. 


b. Name an authorized dump receiver. 
Name an authorized recovery machine. 


GCS requires you to enter a recovery machine user ID. The GROUP EXEC tells you whether that 
user ID is valid, but it does not prevent you from saving an invalid entry. 


c. Specify a trace table size. 


By default, the GROUP EXEC saves a value of 16K. If you decide to save a different amount, 
simply type the new value over the defauit value. 


d. Save your input. 


If you are satisfied with your choices, press PF6 or ENTER to save the information. 


Warning: If you do not save the information before going on, the system will not accept it as input. 
e. Go to the second panel. 


Press PF8 to continue on the second Saved System Information panel. 
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GRP122 SAVED SYSTEM INFORMATION FOR < PAGE 2 OF 2 


To ADD, fill in the blanks with the information. 
To CHANGE, type the information over the displayed value. 
To DELETE, type blanks on the line. 


Pressing the ENTER key or PF6 key will save the update. 


MAXIMUM NUMBER of VIRTUAL MACHINES (required). .: 


SYSTEM ID (maximum 130 characters) 


PF: 1 HELP 2 CLEAR 3 END ai 5 REFRESH 6 SAVE 
PF: 7 PREVIOUS 8 ... O° aces ove HS 66 12 CURSOR 


sSsosc> 


11. To complete the second Saved System Information panel: 
a. Specify a MAXIMUM NUMBER. 


Simply type a value of 1 or more, and press ENTER. The GROUP EXEC responds with a message 
only if you enter an invalid value. 


b. Type in your SYSTEM ID text. 


This 1s optional. Move the cursor to the SYSTEM ID space (if it is not already there) and enter 
your text. The GROUP EXEC does not let you enter any more than 130 characters. 


c. Save your input and return to the Primary Option Menu. 


Press ENTER to save your information and then press PF3. 
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GRP13 AUTOMATIC SAVED SEGMENT LINKS FOR < PAGE 1 OF 1 


To ADD, fill in the blanks with the saved segment names 
that will be linked automatically during 
initialization of this virtual machine group. 

To CHANGE, type a new saved segment name over the saved 
segment name to be changed. 

To DELETE, type blanks on the line. 


Pressing the ENTER key or PF6 key will save the update. 


PF: 1 HELP 2 CLEAR 3 END san REFRESH 6 SAVE 
PF: 7 PREVIOUS 8 NEXT 9 VERIFY 10 ... US. 12 CURSOR 


12. To complete the Automatic Saved Segment Links panel: 
Note: Do not include CMSVSAM and CMSBAM segments here. 
a. Type in the segment names. 


Press ENTER or PF6 after typing each segment name to save your information and advance to the 
next space at the same time. Every time you press ENTER or PF6, the EXEC tells you how many 
segment names it has processed. Use PF7 and PF8 if you have more than one screen of names. 


b. Return to the Primary Option Menu. 


If you have not saved your input yet, press ENTER or PF6. Press PF3 to return to the primary 
option menu. 


13. Once you have provided the necessary input on all panels and returned to the primary option menu for 
the last time, press PF3 to exit from the GROUP EXEC. 


14. Remove the temporary GCS message file from user storage and erase it on your A-disk: 


set language langid (delete csi user Ml langid is your system default national language. If 
erase csiume[y| text a you have not installed a different one, your default 
is ameng. 


15. Spool punch output to your own virtual reader: 


spool punch * @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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16. 


Invoke the ITASK EXEC with the BUILD GCS parameters: 


itask build gcs systemname @ systemname must match the name you specified 
when you issued the GROUP EXEC. If you do 
not specify a name, the default is GCS. 


HCPNSD440I The Named Saved System (NSS) systemname 
was successfully defined 
in fileid fileno 
OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nnon NSS S_— nnnn mm/dd hh:mm:ss GCS NSS MAINT 


DMSUPD181E No update files were found 
DMSWHM1907I Assembling systemname 
DMSWHM1909I systemname TEXT A created 
191 replaces A (191) 

5E5 replaces B (5E5) 


| If You Receive an Assembly Error | 


Note: If you receive an assembly error, you may have to reestablish the minidisk access order: 


acc 5£5 b @ 
vmfsetup 56643089 gcs (all MI erase 56643089 $setup a Mf 


Then go back and check your configuration file, which ITASK has renamed systemname 
ASSEMBLE. Refer to “Planning for the Group Control System (GCS)” on page 9 for 
information regarding required fields. Correct the file or go through the GROUP EXEC panels 
again to recreate the file. (If you recreate the configuration file, you must use the same 
systemname.) After you recreate the configuration file, rename or erase the old systemname 
ASSEMBLE file, then rename the new configuration file from GROUP to ASSEMBLE. Issue the 
ITASK BUILD GCS systemname command to assemble the configuration file and to build and 
save the nucleus. 


( End of If You Receive an Assembly Error ee 


iT: 
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PRT FILE fileno SENT FROM MAINT PRT AS fileno These are informational messages. You can 
RECS nnnn COPY 001 A NOHOLD NOKEEP ignore them. 

nnonnnnn FILES CHANGED 

LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


RDR FILE fileno SENT FROM MAINT PUN AS fileno The GCS nucleus has been sent to MAINT’s 
RECS nnnn COPY 001 A NOHOLD NOKEEP virtual reader. 


Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be that a 
PTF now being applied has another PTF, outside 
GCS, as a prerequisite. Check the $VMFBLD 
SERRLOG file for message DMSBNC1854W. 


Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build @& 
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18. 


20. 


21. 


Copy the text deck, configuration file, ASSEMBLE file, and EXEC from MAINT 191 to MAINT 495: 


access 495 d Hf 

Ready; T=n.nn/n.nn hh:mm:ss 

copy systemname text a = = d (replace @ 
Ready; T=n.nn/n.nn hh:mm:ss 

erase systemname text a Hi 

Ready; T=n.nn/n.nn hh:mm:ss 

copy systemname group a = = d (replace Mf 
Ready; T=n.nn/n.nn hh:mm:ss 

erase systemname group a Hf 

Ready; T=n.nn/n.nn hh:mm:ss 

copy systemname assemble a = = d (replace 
Ready; T=n.nn/n.nn hh:mm:ss 

erase systemname assemble a Wm 

Ready; T=n.nn/n.nn hh:mn:ss 


. Verify that the GCS nucleus is in MAINT’s virtual reader: 


query rdr maint all The ALL operand requests a display of all 
information about the reader files. 

ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT noon * PUN nannnnnn 001 NONE mm/dd hh:mm:ss fn ft SYSPROG 


Ready; T=n.nn/n.nn hh:mm:ss 
This is the file that you will IPL in substep 22 on 
page 88. It has approximately 8,000 records. The 
exact size varies according to the system default 
language, local modifications, and VMSUP level. 


The name of the IPL deck is the same as the last 
entry in the GCS load list. If you have difficulty 
identifying the IPL deck and need to know the 
reader file number, refer to the last entry in the 
GCS load list systemname EXEC. (The default 
name is GCSLOAD EXEC). 


Order your reader so that the GCS nucleus will be processed first: 


order rdr fileno fileno is the file number of the GCS nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


Query the reader. If it is not class *, spool it as class *: 


query virtual c @ 

RDR OOOC CL cl NOCONT NOHOLD EOF READY 
000C nnnnnCLOSED NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 

spool c class * & 

Ready; T=n.nn/n.nn hh:mm:ss 
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22. 


23. 


Load (IPL) MAINT’s virtual reader: 


ip] 00c clear @ 


MSG FROM MAINT : CSIINI134I systemname has nnnnnn 
bytes of available common free storage 
HCPNSS440I Named Saved System (NSS) systemname 
was successfully saved in fileid fileno 


PRT FILE fileno SENT FROM MAINT PRT WAS fileno This message indicates that the GCS load map file 


RECS nnnn CPY 001 NOHOLD NOKEEP has been sent to MAINT’s virtual printer. If you 
plan to save or print the GCS load map, record 
fileno. 

IPL 190: 
ip] 199 @ 


DMSWSP327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 


a 
Ready; T=n.nn/n.nn hh:mm:ss 


Note: If necessary, purge your reader to free spool space. 


| Saving and Printing the GCS Load Map | 


24. 
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The GCS load map has been sent to MAINT’s virtual printer. To save the load map on disk, issue the 
following commands: 


query prt all # 

OWNERID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT fileno A PRT nnnnnnnn 001 NONE mm/dd hh:mm:ss SYSPROG 

Ready; T=n.nn/n.nn hh:mm:ss The GCS load map is the file with a blank 
filename and filetype. It has approximately 2,200 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUP level. 


Note the fileno of this file. You will use it in your 
next command. 


#cp transfer prt fileno to * rdr 
access 495 d @ 
receive fileno fn ft d @ 


You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as | —9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 
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Once you have the load map saved on disk, you can print a copy of it by issuing the following command: 


print fn ft d @ 


[| sind of Saving and Printing the GCS Load Map _______—Sd 


| Installing Multiple GCS Systems | 


25. You can install more than one GCS system, if you defined the additional systems in the system directory. 
To install each additional system: 
a. Reestablish the minidisk access order: 
access 5E5 b @ 


vmfsetup 56643089 gcs (all @ 
erase 56643089 $setup a 


b. Set up the GROUP EXEC messages in storage (full-screen display devices only): 


copyfile csimes[y] [text|txtnnnnn] fm csiume[y |text a 


The CSIMES text file is shipped as TXTnnnnn. The most current version of this file can be 
determined by referring to the first entry in the CSIMES AUX file. In the first entry, there is a 
UMnannnn field, where nnnnn is the PTF number. 


Note: If you have not received service on the CSIMES text file, you do not have a CSIMES file 
with a filetype of TXTnnnnn. You will have one with a filetype of TEXT. 


set language langid (add csi user @ 


c. Create a configuration file for each nucleus. 
e If you are using a full-screen display device, issue: 
group systemname systemname is a unique filename. Then 


complete the GCS panels to define the system 
parameters. 


e If you are not using a full-screen display device, refer to the VM/XA SP Group Control System 
Command and Macro Reference. Use the build macros to create the configuration file. 


d. Remove the temporary GCS message file from user storage and erase it from your A-disk (full-screen 
display devices only): 


set language langid (delete csi user Mf 
erase csiume[y| text a 


e. For each new GCS system, add a DEFSYS statement to the SAMPNSS EXEC, For information on 
the DEFSYS command, see the VM/XA SP CP Command Reference. 
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f. For each new GCS system, add an override section at the end of the product parameter file. This 
example shows an override section for a GCS system called NEWGCS: 


:NEWGCS. GCS 

:BLD. REPLACE 

NEWGCS VMFBDNUC BUILD1 
> END. 


You must also add the name of the new GCS system to the :OVERLST. tag at the top of the 
product parameter file, for example: 


sOVERLST. CORCP CORCMS CORGCS NEWGCS 


g. For each GCS system, assemble the configuration file, build and save the new GCS nucleus, and 
copy the text deck, configuration file, ASSEMBLE file, and EXEC to the 495 disk: 


access 5£5 b # 
vmfsetup 56643089 gcs (all @ 
erase 56643089 $setup a &@ 


itask build gcs systemname @ 
access 495 d @ 

copy systemname text a = = 
erase systemnome text a Hf 
copy systemname group a = = d (replace 
erase systemname group a @ 

copy systemname assemble a = = d (replace @ 
erase systemname assemble a Mf 

ip] @0c clear @ 

ip] cms @ 


d (replace @ 


Before you build another GCS nucleus, save or print the GCS load map, as indicated above. 
Remember to give each load map file a different name. 


[| sé nd of Installing Multiple GCS Systems. —S—SCSC~sdC 
26. Verify that all your GCS segments were defined correctly: 


query nss all @ 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS = fileno NSS R_=nnnn mm/dd hh:mm:ss GCS NSS MAINT 
*NSS fileno NSS R= nannn mm/dd hh:mm:ss systemname NSS MAINT 


27. When you complete your GCS installation, go to “Step 27. Save CMS” on page 91. 
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Step 27. Save CMS 


In this step, you will save CMS as a named saved system in 370 mode and 370-XA mode, at default 


addresses. 


This step takes approximately 10 minutes. 


Note: For general information about CMS as a named saved system, see VM/XA SP Planning and 


Administration. 
1. Make sure: 


e You are logged on as MAINT. 


¢ You have finished loading all files to the 190 and 19E minidisks. After this step, any change to files 


on these disks requires resaving CMS. 


¢ You have 16 megabytes of virtual storage. To determine your storage size, issue QUERY 
VIRTUAL STORAGE. If you have less than 16 megabytes, issue DEFINE STORAGE 16M. 


e CMS is running. If not, load CMS by issuing IPL 190 CLEAR. Wait for the CMS version 
identification to appear on the screen. Then press ENTER. 


to 


. Invoke the SAMPNSS EXEC: 


sampnss cms cmsxa Mf 


HCPNSD440I Named Saved System (NSS) CMS was 
successfully defined in fileid fileno 


HCPNSD440I1 Named Saved System (NSS) CMSXA was 
successfully defined in fileid fileno 


The SAMPNSS EXEC issues the DEFSYS 
command. 


Note: If you use “CMS” (the default name) for 
the System/370 name, users will receive the 
new level of CMS whenever they issue the 
command IPL CMS. 


The SAMPNSS EXEC first issues the DEFSYS 
command to define a skeleton system data file for 
CMS and for CMSXA. These messages tell you 
the DEFSYS commands were successful. 


The names shown in the SAMPNSS command are 
the default names for the System/370 (CMS) and 
for the 370-XA (CMSXA) systems. Of course. 
you may name these systems whatever you wish; 
but if you change the names you must either edit 
the SAMPNSS EXEC to use your names or define 
your systems manually. 


Note: The names are positional on the command 
(the System/370 name followed by the 
370-XA name). 
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OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nnonn NSS S— nnnn mm/dd hh:mm CMS NSS MAINT 
*NSS nnnn NSS) S— nnnn mm/dd hh:mm CMSXA NSS MAINT 
REA GYs Tannen DiaMmes The SAMPNSS EXEC issues a QUERY NSS 


command. These messages show what system 
data files are defined. 


Issue the QUERY NSS ALL MAP command to make sure CMS is defined properly. Check whether the 
information under BEGPAG, ENDPAG, TYPE, and CL in the response to QUERY NSS ALL MAP 1s 
the same as shown. 


query nss all map @ 
FILE FILENAME FILETYPE MINSIZE BEGPAG ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


nnnn CMS NSS 000256K 00000 OQO0A EW S Q0000 OMITTED NO 
00020 00022 €EW 
QOOEOO OOFFF SR 

nnnn CMSXA NSS 000256K 00000 OO000A EW S 00000 OMITTED NO 
00020 00022 #£4€EW 
QOEOO OOFFF SR 

Ready; T=n.nn/n.nn hh:mm:ss 


. Set your machine mode to 370, load CMS (IPL 190), and save the CMS system: 


set machine 370 Mf If your machine is already in 370 mode, you will 

SYSTEM RESET not get a response. 

SYSTEM = 370 

ip! 196 clear parm savesys cms Mf | Load 190 with the option to save the system under 

HCPNSD440I Named Saved System (NSS) CMS was the name CMS. 

successfully saved in fileid fileno 
DMSWSP327I The installation saved segment Disregard the message about not loading the saved 
could not be loaded segment; CMS has been successfully saved as a 

named saved system. 

VM/XA CMS 5.6 mm/dd/yy hh:mn If you have changed the version heading, your 
own heading will appear. 

2 Press ENTER to initialize CMS. 


SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 


. Set your machine mode to XA, load CMS (IPL 190), and save the CMSXA system: 


set machine xa If your machine 1s already in 370-XA mode, you 
SYSTEM RESET do not get a response. 

SYSTEM = XA 

ip! 190 clear parm savesys cmsxa Ml Load 190 with the option to save the system under 


HCPNSD440I Named Saved System (NSS) CMSXA was the name CMSXA. 
successfully saved in fileid fileno 
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DMSWSP327I The installation saved segment Disregard the message about not loading the saved 


could not be loaded segment; CMSXA has been successfully saved as a 
VM/XA CMS 5.6 mm/dd/yy hh:mm named saved system. 
a Press ENTER to initialize CMS. 


SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 


. Set your machine mode to 370 (or XA), redefine your virtual storage to 2 megabytes, and load the CMS 
(or CMSXA) named saved system. The example below shows loading CMS in System/370 mode: 


set machine 3760 If your machine is already in 370 mode, you will 
SYSTEM RESET not get a response. 

SYSTEM = 370 

define storage 2m Hf 


STORAGE = 2M Defining storage causes a system reset. 
Storage cleared - system reset 

ip] cms @ 

DMSINS327I The installation saved segment could not be loaded 

VM/XA CMS 5.6 mm/dd/yy hh:mm 


ee After receiving the CMS version identification, 
SYNONYM SYN press ENTER to complete CMS or CMSXA 
CP TERM MODE VM initialization. 


Ready; T=n.nn/n.nn hh:mm:ss 


. Check the CMS status by issuing QUERY NSS ALL and QUERY NSS ALL MAP. Check whether the 
information under FILENAME and FILETYPE in the response to QUERY NSS ALL is the same as 
shown. Also, check whether the information under BEGPAG, ENDPAG, TYPE, and CL in the 
response to QUERY NSS ALL MAP is the same as shown. The system data file should now have class 
A (rather than S) and have one user (MAINT). 


query nss all & 
OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS A nnnn mm/dd hh:mm:ss CMS NSS MAINT 
*NSS nnonn NSS) A_ nnnn mn/dd hh:mm:ss CMSXA NSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


query nss all map 
FILE FILENAME FILETYPE MINSIZE BEGPAG ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


nnnn CMS NSS 000256K 00000 Q000A EW A Q0001 OMITTED NO 
00020 00022 EW 
QOEOO OOFFF SR 

nnnn CMSXA NSS 000256K 00000 O000A EW A @0000 OMITTED NO 
00020 00022 #£2€EW 
QOEOO OOFFF SR 

Ready; T=n.nn/n.nn hh:mm:ss 
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Redefine your storage before you continue with the following steps: 


define storage l6m @ 

STORAGE = 16M 

Storage cleared - system reset 

ip! 190 clear @ 

DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

i 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hhemm:ss 
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Step 28. Install the CMSDOS, CMSBAM, CMSVSAM, and CMSAMS 
Saved Segments 


If you plan to use the CMS/DOS environment or the VSAM product, you must install the CMSDOS, 
CMSBAM, CMSVSAM, and CMSAMS saved segments. 


If you do not want to install these saved segments, go to “Step 29. Create the CMSINST and HELP 
Saved Segments” on page 103. 


In this step, you will: 


e Install CMSDOS and CMSBAM in separate saved segments 
e Create a CMSVSAM segment and install the VSAM product tape 
e Create a CMSAMS segment and install Access Method Services. 


This step takes approximately | hour. 


Warning: The CMSDOS and CMSBAM segments must be installed before you install CMSVSAM and 
CMSAMS. 


Note: For more information about saved segments, see VM/XA SP Guide to Saved Segments. 


1. IPL 190. This is the CMS system disk. 


define storage 16m & 

STORAGE = 0016M 

STORAGE CLEARED - SYSTEM RESET 

ip! 190 clear @ 

DMSINS327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mn Your own installation header appears if you have 
hanged it. 

** DO NOT press ENTER! ** enpaen 

access (noprof This command suppresses execution of MAINT’s 

Ready; T=n.nn/n.nn hh:mm:ss PROFILE EXEC. 

access 193 e & Access the disks with installation and service 

access 5E5 b @ EXECs, and the DOSGEN EXEC. 

Ready; T=n.nn/n.nn hh:mm:ss 

set emsg on @ You want to see any and all error messages during 

Ready; T=n.nn/n.nn hh:mm:ss execution of the installation EXEC. 


2. Define a segment into which the DOSGEN EXEC can load CMSDOS: 


defseg dosinst 900-90f sr Hf This command defines a 1M segment for 
HCPNSD440I Saved segment DOSINST was DOSINST starting at 900000. You may place this 
successfully defined in fileid segment anywhere below the segment spaces 
fileno defined for CMSDOS, CMSBAM, CMSVSAM,., 
Ready; T=n.nn/n.nn hh:mm:ss and CMSAMS. 
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3. Invoke the DOSGEN EXEC with a load address and the name DOSINST. The load address used for 
DOSINST in this example is 900000. 


dosgen 900000 dosinst @ The load address and name are those 

HCPNSS440I Saved segment DOSINST was recommended for the DOSINST segment. Error 
successfully saved in fileid messages for the DOSGEN EXEC are listed on 
fileno page 97. 


PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 

DMSWGN715I DOSGEN COMPLETE 

Ready; T=n.nn/n.nn hh:mm:ss 


4. IPL CMS: 


ip] cms @ 
DMSINS327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm 
| 


SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 


5. Define CMSDOS, CMSBAM, CMSAMS, and CMSVSAM: 


set sysname cmsdos dosinst Hf 


Ready; T=n.nn/n.nn hh:mm:ss 
sampnss cmsdos 


HCPNSD440I Saved segment CMSDOS was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) A nnnn mm/dd hh:mm:ss DOSINST DCSS MAINT 
*NSS nnnn NSS S_— nann mm/dd hh:mm:ss DOSBAM — DCSS MAINT 
*NSS nnnn NSS S— nnnn mn/dd hh:mm:ss CMSDOS — DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


sampnss cmsbam 


HCPNSD440I Saved segment CMSBAM was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS S— nnann mn/dd hh:mm:ss CMSBAM  DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


Sampnss cmsams 
HCPNSD440I Saved segment CMSAMS was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS S— nnnn mm/dd hh:mm:ss CMSAMS — DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
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sampnss cmsvsam @ 
HCPNSD440I Saved segment CMSVSAM was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nann NSS S— onnnn mm/dd hh:mm:ss CMSVSAM_ DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Invoke the DOSGEN EXEC with a load address and the name CMSDOS. The load address set up by 
SAMPNSS is B00000 for the name CMSDOS. 


access 193 e Mf Access the disks with installation and service 

Ready; T=n.nn/n.nn hh:mm:ss EXECs. 

dosgen b06060 cmsdos @ 

HCPNSS440I Saved segment CMSDOS was successfully 

saved in fileid fileno 

PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 

DMSGEN715I DOSGEN COMPLETE 

Ready; T=n.nn/n.nn hh:mm:ss 


The load address and name are those 
recommended for the CMSDOS segment. Error 
messages for the DOSGEN EXEC are listed on 


page 97. 


| 7. To save the load map, rename it and copy it to the alternate LOCALI minidisk (395): 


| access 395 d 

| DMSACC7241 395 replaces D(395) 

| Ready; T=n.nn/n.nn hh:mm:ss 

| copy load map a cmsdos segmap d @ 
Ready; T=n.nn/n.nn hh:mm:ss 


Error Messages from DOSGEN 
If DOSGEN detects an error in the address that you specified: 
DMSGENO95E INVALID ADDRESS 
If DOSGEN cannot find a read/write accessed A-disk: 
DMSGENOO6E NO READ/WRITE A-DISK ACCESSED 
If DOSGEN finds unresolved external references while loading the text files: 
DMSGEN111E DOSGEN FAILED DUE TO LOAD ERRORS 
If DOSGEN detects an error while assigning the storage key or saving the segment: 
DMSGEN412S DOSGEN FAILED DUE TO SETKEY ERRORS 


DMSGEN141S DOSGEN FAILED DUE TO SAVESYS ERRORS 
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Replace the name CMSBAM in the CMS SYSNAME table with any name that is not a name previously 
used as a segment name: 


set sysname cmsbam sysname The SET SYSNAME command enters an 

Ready; T=n.nn/n.nn hh:mm:ss alternate name for CMSBAM in the SYSNAME 
table. Choose a name that was not used 
previously as a segment name. This command 
does not actually change the saved segment’s 
name, but keeps CP from finding and IPLing the 
segment at the wrong time. 


. Place your CMS virtual machine in a CMS/DOS environment, then invoke SAMGEN to load the 


CMSBAM segment. You must give the EXEC an address at which to load the CMSBAM segment; this 
address also must match the address in the skeleton CMSBAM segment that you defined beforehand. 


set dos on This command places your virtual machine in a 
CMS/DOS environment. 

DMSSET400I SYSTEM sysname DOES NOT EXIST You may receive these informational messages. 

DMSSET1101I 100K DOS partition defined sysname is the name you chose in substep 8. 


at hexadecimal location 020000. 
Ready; T=n.nn/n.nn hh:mm:ss 
samgen @ 
DMSSGN363R ENTER LOCATION WHERE CMSBAM 
WILL BE LOADED AND SAVED: 


b10000 @ 

DMSSGN364I FETCHING CMSBAM... 

DMSFET710I PHASE DMSVBM ENTRY POINT AT LOCATION B100CO. 
DMSSGN366R ENTER NAME OF SYSTEM TO BE SAVED: 

cmsbam @ 


HCPNSS440I Saved segment CMSBAM was successfully The messages indicate that the segment has been 
saved in fileid fileno loaded and saved. 

DMSSGN365I SYSTEM CMSBAM SAVED 

Ready; T=n.nn/n.nn hh:mm:ss 


. Set DOS off: 


set dos off 
Ready; T=n.nn/n.nn hh:mm:ss 


Define and format a minidisk for VSAM files. 


a. Map your USER DIRECT and examine the map to find a space for the new minidisk. Look for a 
gap of appropriate size and record the starting cylinder of that gap. The number of cylinders needed 
depends on the DASD type: 


Device Cylinders Needed 


3350 15 cylinders 
3375 22 cylinders 
3380 14 cylinders 
3390 14 cylinders 
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access 295 d Refer to the directory map to find a gap. 


Ready; T=n.nn/n.nn hh:mm:ss Repeat the locate command as many times as 
diskmap user direct necessary. When you find a suitable gap. note 
File USER DISKMAP A has been created. the starting cylinder and DASD label the 
Ready; T=n.nan/n.nn hh:mm:ss cylinders reside on and leave the file. 


xedit user diskmap 
locate/GAP 

qquit @ 

Ready; T=n.nn/n.nn hh:mm:ss 


. XEDIT your directory and add an entry for the new minidisk: 


xedit user direct 


locate/USER MAINT Locate the MAINT minidisk definitions. 
locate/MDISK @ 
input @& 


MDISK vdevno devtype startcyl cyls label MW ALL @ 


vdeyno, devtype, and label are the address, device 
type, and label of the DASD volume where the 
new minidisk is located. startcy/ is the starting 
cylinder of the gap where the new minidisk is 
defined. cyl/s is the number of cylinders needed 
for the minidisk. 


ai) Press ENTER to return to the command line. 
file 


. Map the directory again and examine the map to make sure that the new minidisk was created in the 
place you specified and that it does not overlap any existing minidisks: 


diskmap user direct @ 


. Issue DIRECTXA to update the directory and bring it online: 


directxa user Hf 

VM/XA SYSTEM PRODUCT USER DIRECTORY CREATION PROGRAM - RELEASE 2.1 
EOJ DIRECTORY UPDATED AND ONLINE 

Ready; T=n.nn/n.nn hh:mm:ss 


. Link to the new minidisk: 


link * vdevno vdevno @& 
Ready; T=n.nn/n.nn hh:mm:ss 
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f. Format the new minidisk: 


format vdevno v (blksize 2048 @ 

DOMSFOR603R FORMAT will erase all the files on disk V(vdevno). 
Do you wish to continue? 
Enter 1 (YES) or O (NOQ). 

1 & 

DMSFOR605R Enter disk label: 

label 

DMSFOR733I Formatting disk V 

DMSFOR732I nn cylinders formatted on V(vdevno) 

Ready; T=n.nn/n.nn hh:mm:ss 


g. Access the new minidisk as A: 


access vdevno a @ 
Ready; T=n.nn/n.nn hh:mm:ss 


12. Set DOS on: 


set dos on @ You may receive these informational messages. 
DMSSET400I SYSTEM sysname DOES NOT EXIST sysname is the name you chose in substep 8 on 
DMSSET1101I 100K DOS partition defined page 98. 


at hexadecimal location 020000. 
Ready; T=n.nn/n.nn hh:mm:ss 


13. Mount the VSAM product tape on a tape drive attached to MAINT at virtual address 181. (If you do 
not have the proper class authority to attach a tape, the system operator may have to do it for you.) 


14. Invoke VSAMGEN EXEC: 


vsamgen @ 
SELECT ONE OF THE FOLLOWING FUNCTIONS BY ENTERING THE NUMBER: 


1. INSTALL AMS (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
2. INSTALL VSAM (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
3. INSTALL VSAM AND AMS (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
4. BUILD AMS (BUILD DOSLIB, CREATE SEGMENT) 

5. BUILD VSAM (BUILD DOSLIB, CREATE SEGMENT) 

6. BUILD VSAM AND AMS (BUILD DOSLIB, CREATE SEGMENT) 

7. RESTART AMS (CREATE SEGMENT) 

8. RESTART VSAM (CREATE SEGMENT) 

9. RESTART VSAM AND AMS = (CREATE SEGMENT) 

10. QUIT (EXIT VSAMGEN EXECUTION) 


ENTER RESPONSE... 


Choosing option 3 tells the EXEC to create both CMSVSAM and CMSAMS segments as new segments. 
If this is the initial installation of VSAM, select function 1, 2, or 3. 


If the text files have already been created from the VSAM product tape and are currently on the accessed 
A-disk, select function 4, 5, or 6. 


If the DOSLIBs currently reside on an accessed disk, select function 7, 8, or 9. In this case, it is not 
necessary to have the text files available. 
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DMSVGN365R ONE OR MORE OF THE TEXT FILES LISTED IN THE CMSVSAM EXEC 
ARE MISSING. THE VSAM PP PID TAPE SHOULD BE ON TAPE DRIVE 181 
TO RESTORE THE FILES. ENTER: 
'GO' IF TAPE DRIVE IS READY TO LOAD FILES, 
‘QUIT’ TO STOP GENERATION PROCESS. 
go 


Messages from VSAMGEN 


While VSAMGEN is processing, you may receive error and information messages. These messages 
are self-explanatory. Messages labeled 21011 are information messages from the linkage editor and 
may be ignored. 


Respond to the EXEC messages as they appear: 


DMSVGN362I LINK-EDITING CMSVSAM ... 
DMSVGN363I CMSVSAM DOSLIB CREATED ON DISK ‘A’. 
DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER 'QUIT'. 
go @ 
DMSVGN363R ENTER LOCATION WHERE CMSVSAM SHARED WILL BE 
LOADED AND SAVED: 


ba0000 


DMSVGN363R ENTER LOCATION WHERE CMSVSAM NONSHARED WILL BE 
LOADED AND SAVED: 
a30000 & 


DMSVGN364I FETCHING CMSVSAM ... 

DMSFET710I1 PHASE DMSVVS ENTRY POINT AT LOCATION nnnnnn 

DSMVGN371R CMSVSAM IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
'CP' MODE, APPLY THE ZAPS AND THEN REPLY ‘GO' 

go B 

DMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


cmsvsam This name is the default name with which the 
segment was defined. 


DMSVGN365I SYSTEM CMSVSAM SAVED. 


DMSVGN368R ERASE CMSVSAM DOSLIB ? ... ENTER 'YES' OR 'NO': 
no @ 


DMSVGN362I LINK-EDITING CMSAMS ... 
DMSVGN363I CMSAMS DOSLIB CREATED ON DISK 'A'. 
DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER ‘QUIT’. 
go 
DMSVGN363R ENTER LOCATION WHERE CMSAMS SHARED WILL BE 
LOADED AND SAVED: 
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b40000 This is the recommended location. 
DMSVGN363R ENTER LOCATION WHERE CMSAMS NONSHARED WILL BE 
LOADED AND SAVED: 

a00000 

DMSVGN364I FETCHING CMSAMS ... 

DMSFET710I PHASE DMSVAS ENTRY POINT AT LOCATION nnnnnn 

DMSFET710I PHASE DMSVAN ENTRY POINT AT LOCATION nnnnnn 

DMSFET710I PHASE DMSVAX ENTRY POINT AT LOCATION nnnnnn 

DMSVGN371R CMSAMS IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
'CP' MODE, APPLY THE ZAPS AND THEN REPLY 'GOQ' 

go & 

OMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


cmsams This name is the default name used for defining 
the segment. 


DMSVGN365I SYSTEM CMSAMS SAVED. 


DMSVGN368R ERASE CMSAMS DOSLIB ? ... ENTER 'YES' OR 'NO': 
no # 


Ready; T=n.nn/n.nn hh:mm:ss 


15. You may now purge the DOSINST named saved segment: 


query nss all @ 
OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) A_nnnn mm/dd hh:mm:ss DOSINST ODCSS MAINT 


Ready; T=n.nn/n.nn hh:mm:ss 


purge nss fileno fileno is the file identifier for DOSINST. 
No files purged 

0001 file pending purged 

Ready; T=n.nn/n.nn hh:mm:ss 

set dos off @ 

Ready; T=n.nn/n.nn hh:mm:ss 
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Step 29. Create the CMSINST and HELP Saved Segments 


In this step, you will: 


e¢ Define a segment to contain EXECs and System Product Editor macro instructions 
e Use the DCSSGEN command to load and save the CMSINST segment 
e Save the HELP file directory in a saved segment. 


Notes: 


1. You must have the NAMESAVE HELP statement in your user directory in order to save the 
HELP file directory information in a saved segment. 


See “Step 21. Update the User Directory” on page 71. 


. If the HELP segment is defined as a member of a segment space, you must have a NAMESAVE 
statement (for example, NAMESAVE INSTHELP) in the directory entry for the user who 
invokes SAVEFD. SAVEFD specifies the name of the segment space. 


This step takes approximately 20 minutes. 


Note: For more information about saved segments, see VM/XA SP Guide to Saved Segments. 


1. Log on as MAINT (unless you are continuing from the previous step). 


2. Check your virtual storage. If it is less than 16M, issue the following: 


define storage l6m @ 
STORAGE CLEARED - SYSTEM RESET 
STORAGE = Q016M 


3. IPL CMS: 


ip] cms @ 
DMSWSP327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm If you have changed the version heading, your 
own heading will appear. 


a Press ENTER to complete the CMS initialization. 
SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


4. Use the SAMPNSS EXEC to define a segment for CMSINST: 


Note: If you have increased the number of entries in the CMS load list, be sure that the DEFSEG entry 
for CMSINST in the SAMPNSS EXEC has enough pages defined to accomodate the increased 
size. 


sampnss cmsinst Hf 
HCPNSD440I Saved segment CMSINST was successfully 
defined in fileid fileno 
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OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nnnn NSS S  onnnn mm:dd hh:mm INSTHELP DCSS MAINT 
*NSS nnonnn NSS S— nnnn mn:dd hh:mm CMSINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


The EXEC issues a QUERY command that 
displays information about the segments defined 
for named saved systems. 


5. Define the HELP segment: 


sampnss help @ 
HCPNSD440I Saved segment HELP was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nnnn NSS SS nnnn mm:dd hh:mm INSTHELP DCSS MAINT 
*NSS noann NSS So nnnn mm:dd hh:mm CMSINST DOCSS MAINT 


*NSS nonn NSS) S  onnnn mn:dd hh:mm HELP DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Save both segments: 


Saveseg cmsinst Each member saved segment defined by 
HCPNSS440I Saved segment CMSINST was SAMPNSS must be saved separately. 
successfully saved in fileid 
fileno 


Ready; T=n.nn/n.nn hh:mm:ss 

saveseg help @ 

HCPNSS440I Saved segment HELP was successfully 
saved in fileid fileno 

Ready; T=n.nn/n.nn hh:mm:ss 


7. Redefine each segment to create the skeleton segments: 


sampnss cmsinst @ 
HCPNSD440I Saved segment CMSINST was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nnnn NSS S— nnann mn:dd hh:mm CMSINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


sampnss help 
HCPNSD440I Saved segment HELP was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nnnn NSS S— nnann mm:dd hh:mm CMSINST DCSS MAINT 


*NSS nnnn NSS S—onnnn mn:dd hh:mm HELP DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
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8. If you do not want to use the sample load list, CMSINST EXECLIST, for the DCSSGEN command, use 
the System Product Editor (XEDIT) to create your own load list: 


xedit instlist file a Hi 
input # 


* Rename RDRLIST EXEC to MAIL EXEC 
RDRLIST EXEC * MAIL = 

FILELIST EXEC S$ 

SYSPROF EXEC S 

PARSE XEDIT S 

DISCARD EXEC S 

NOTE EXEC S 

PROFNOTE XEDIT S 

ALL XEDIT S @& 


|| 
file @ 


This 1s a sample. Enter the load list entries you 
need. 


Only one comment line per list is allowed; it must 
be the first line. For more information on 
creating this list, see “DCSSGEN Command” on 
page 580. 


The remainder of the lines contain entries for 
frequently used EXECs and Editor macros; 
multiple users can share the same executing copy 
of these EXECs and macros. 


Press ENTER to return to the command line. 


9. The load list must have a fixed record length in order for you to use the DCSSGEN command. If your 
load list has variable length records, change it to a fixed length file by issuing: 


copyfile fn ft fm = = = (recfm f lrecl 86 replace 


10. Invoke the DCSSGEN command: 


access 1933 e B 
dcssgen fn ft fm cmsinst Hf 


HCPNSS440I Saved segment CMSINST was successfully 
saved in fileid fileno 
Ready; T=n.nn/n.nn hh:mm:ss 


jn ft fm is the file ID of the file that contains the 
list of EXECs and Editor macros to be loaded into 
the segment, either CMSINST EXECLIST fm or 
your own file (for example, INSTLIST FILE A). 


CMSINST is the name of the segment you want 
to create. It is also the default name of the 
installation saved segment in the DMSNGP 
profile. If you changed the name in the 
DMSNGP profile, or specified a different name in 
response to the installation questions (see page 
50), use that name instead. If you do not specify 
a segment name, the DCSSGEN command 
defaults to CMSINST. 
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The DCSSGEN command creates a load map file. CMSINST DCSSMAP A. For the sample load list 
created in substep 8 on page 105, the load map would look like this: 


* RENAME RDRLIST EXEC TO MAIL EXEC 
RDRLIST EXEC * MAIL = 
- 15:41:59 10/22/85 copy of RDRLIST EXEC S loaded as MAIL EXEC 
EXISBLK - 286000 FBLOCK ~ 280100 LENGTH - @01C40 
FILELIST EXEC S 
15:41:58 10/22/85 copy of FILELIST EXEC S loaded as FILELIST EXEC 
EXISBLK - 280020 FBLOCK - 281040 LENGTH - 0018C8 
SYSPROF EXEC S 
7:30:18 11/26/85 copy of SYSPROF EXEC S loaded as SYSPROF EXEC 
EXISBLK - 280040 FBLOCK - 283608 LENGTH - 002178 
PARSE XEDIT S 
8:47:55 12/18/84 copy of PARSE XEDIT S loaded as PARSE XEDIT 
EXISBLK - 280060 FBLOCK - 285780 LENGTH - 0024A0 
DISCARD EXEC S$ 
15:40:32 10/22/85 copy of DISCARD EXEC S loaded as DISCARD EXEC 
EXISBLK - 286080 FBLOCK - 287€20 LENGTH - 0012B0 
NOTE EXEC S$ 
11:03:53 10/24/85 copy of NOTE EXEC S loaded as NOTE EXEC 
EXISBLK - 280Q0A0 FBLOCK - 288ED0 LENGTH - 605310 
PROFNOTE XEDIT S 
15:41:55 10/22/85 copy of PROFNOTE XEDIT  S loaded as PROFNOTE XEDIT 
EXISBLK - 2800CO FBLOCK - 28E1EQ LENGTH - 000980 
ALL XEDIT S 
15:41:05 10/22/85 copy of ALL XEDIT SS loaded as ALL XEDIT 
EXISBLK - 2800E0 FBLOCK - 28EB60 LENGTH - 001298 
*** End of Source List *** 
CMSINST built at 15:56:34 on 12/02/85 


Note: When you built your CMS nucleus, if you indicated in the DMSNGP file CUSEINST = YES) or in 
answer to the DMSINQ296R prompt that you wanted to use the installation segment (the default 
is YES), then this segment is used each time a user IPLs CMS. If you previously indicated that 
you did not want to use the ‘installation segment but now want to use it, you must modify the 
DMSNGFP file to indicate that the segment should be used, then assemble the modified DMSNGP 
and rebuild CMS. (To find the latest version of the DMSNGP file, issue SETUP to access all the 
minidisks where it might be; then issue FILELIST DMSNGP ASSEMBLE *. All the copies of 
DMSNGP ASSEMBLE will be listed, with the date when each one was last modified.) 
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Il. 


Messages from DCSSGEN 


While DCSSGEN is processing, you may receive error or warning messages that indicate specific 
conditions. If errors were encountered, after processing is complete you receive the following prompt: 


DMSEXG298R An error has been detected while building the DCSS. 
Do you still want the DCSS saved? 
Enter 1 (YES) or © (NO). 


Enter 1 to disregard the errors and save the segment, or enter 0 to not save the segment. If you do 
not save the segment, you receive the message: 


DMSEXG288I segname not saved 


If DCSSGEN encounters an error while saving the segment, you receive the message: 
DMSEXG288E dcssname not saved 


If your virtual machine is not large enough to contain the segment (you need 16M), you receive the 
message: 


DMSEXG284E The DCSS is not completely inside the virtual machine 


To correct this situation, increase the size of your virtual machine, re-IPL CMS, and reissue the 
DCSSGEN command. 


Define your virtual storage less than the address at which the HELP segment is to be loaded. For 
example, if the HELP segment is defined at X'C50000' (the default address in the SAMPNSS EXEC) 
define your storage as 12M. 


define storage 12m @ 
STORAGE CLEARED - SYSTEM RESET 
STORAGE = 12M 


Re-IPL CMS: 


ip] cms 

DMSWSP327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

tea 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


. Issue the following commands to initialize and save the segment: 


(For more information about using the SAVEFD command to save minidisk file directory information in 
a saved segment, refer to VM/XA SP CMS Command Reference.) 


savefd init vaddr label help @ vaddr is 19D for mixed-case American English and 
Ready; T=n.nn/n.nn hh:mm:ss 19C for uppercase American English. 
paver e save Yoder coer ae label is the CMS label assigned to the disk. (The 


DMSACP723I Z(19D) R/O 

HCPNSS440I Saved segment HELP was successfully 
saved in fileid fileno 

Ready; T=n.nn/n.nn hh:mm:ss 


labels in the sample directory are MNT19D and 
MNT19C.) 
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14. Verify that the CMSINST and CMSHELP segments were defined correctly: 
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query nss all 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS fileno NSS A_nnnn mm/dd hh:mm:ss INSTHELP NSS MAINT 
*NSS = fileno NSS A_nnnn mm/dd hh:mm:ss CMSINST NSS MAINT 
*NSS fileno NSS A= nnnn mm/dd hh:mm:ss HELP NSS MAINT 


The system data file should now have class A (rather than S) and have one user (MAINT). 


. Redefine your storage before you continue: 


define storage l6m & 

STORAGE = 16M 

Storage cleared - system reset 
ip] cms Hf 

VM/XA CMS 5.6 mm/dd/yy hh:mm 
ra 


SYNONYM SYN 


CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 30. Back Up the Named Saved System Files 


In this step, you will back up all the named saved systems, including CMS, on tape. 


This step takes approximately 10 minutes. 


1. Mount a scratch tape with ring on an available 3420, 3422, or 3430 tape drive, or insert a cartridge with 
the tab protector set to off in an available 3480 tape unit. Follow machine operations manuals to mount 
the tape. 


¢ Do not attach the tape unit to MAINT. 
e The tape must be suitable for a 3420, 3422, 3430, or 3480 tape unit. 
2. Issue the SPTAPE command to dump the CMS system data file to tape: 
sptape dump rdevno nss all run @ Substitute the real device number of the tape drive 
for the value rdevno. The operand RUN specifies 


that the SPTAPE rewinds and unloads the tape 
after the operation. 


DUMPING rdevno NSS *NSS nnonn A The messages from SPTAPE tell you that the file 
: is being dumped to tape. The CMS ready message 
SPTAPE DUMP FUNCTION ON DRIVE rdevno may occur between the messages. 

COMPLETE 


Ready; T=n.nn/n.nn hh:mm:ss 


3. Store the tape for emergency use. If it is ever necessary, you can use this tape and the SPTAPE 
command to restore the CMS system data file. For more information about the SPTAPE command, see 
VM/XA SP Real System Operation. 


To restore your CMS named saved system: 
1. Log on as MAINT. 
2. Mount the backup tape on a tape drive. 


3. Issue: 


sptape load rdevno nss all run @ 
LOADING rdevno NSS *NSS nnnn A NOW nnnn 


LOADING rdevno NSS *NSS nnnn A NOW nnnn 
SPTAPE LOAD FUNCTION ON DRIVE rdevno COMPLETE 


4. IPL CMS: 


ip] cms @ 
VM/XA CMS 5.6 mm/dd/yy hh:mm 
y 


SYNONYM SYN 


CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 31. Store a Backup Copy of CP on Tape 


In this step, you will use DDRXA to store a backup copy of CP on tape. 


The time to perform this step varies based on the device and contention for the device’s channel. It may 
take up to 30 minutes. 


1. Mount a scratch tape (with ring) on a tape drive. Follow machine operations manuals to mount the 
tape. 


2. Attach the tape drive to MAINT at virtual device number 0181: 


attach rdevno * 181 @ The ATTACH command attaches the real device 
TAPE 0181 ATTACHED (rdevno) to MAINT’s virtual machine at virtual 
Ready; T=n.nn/n.nn hh:mm:ss device number 0181. 


3. Load the DDRXA utility to tape. If your tape drive can operate at a density of 6250 BPI, enter the 
commands under 3a. Otherwise, enter the commands under 3b. 


a. If your tape drive can operate at a density of 6250 BPI, enter these commands: 


tape modeset (tapl den 6250 Mf Set the tape density to 6250 BPI. If you receive 

Ready; T=n.nn/n.nn hh:mm:ss message DMSPAR622E, reissue the TAPE 
MODESET command. 

filedef in disk ipl ddrxa s Because this step uses the MOVEFILE 

Ready; T=n.nn/n.nn hh:mm:ss command, you must first use the FILEDEF 

filedef out tapl (den 6250 @ command to establish data definitions for files 

Ready; T=n.nn/n.nn hh:mm:ss to be copied. 


movefile in out 
Ready; T=n.nn/n.nn hh:mm:ss 


Go to substep 4. 


b. If your tape drive cannot operate at a density of 6250 BPI, enter these commands: 


filedef in disk ipl ddrxa s Hf Because this step uses the MOVEFILE 
Ready; T=n.nn/n.nn hh:mm:ss command, you must first use the FILEDEF 
filedef out tapl command to establish data definitions for files 
Ready; T=n.nn/n.nn hh:mm:ss to be copied. 


movefile in out @ 
Ready; T=n.nn/n.nn hh:mm:ss 


4. Change MAINT’s virtual processor configuration to 370-XA architecture: 


set machine xa @ Setting the virtual machine to 370-XA architecture 
SYSTEM RESET causes a reset as if you entered SYSTEM CLEAR. 
SYSTEM = XA If your machine is already in 370-XA mode, you 


will not get a response. 


110 Installation and Service 


ip] cmsxa @ 

VM/XA CMS 5.6 mm/dd/yy hh:mm 
z 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


. Rewind the scratch tape on virtual device number 0181: 


rewind 181 
Rewind complete 


. Load (IPL) the tape and answer the prompts from DDRXA: 


ip! 181 clear @ 


VM/XA SYSTEM PRODUCT DASD DUMP/RESTORE PROGRAM 
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS 
ENTER: 


sysprint cons @ 
ENTER: 


input vdevno devtype xasres @ 
ENTER: 


output 181 devtype (mode 6250 compact @ 
ENTER: 


dump cpvol @ 


DUMPING XASRES 
DATA DUMPED mm/dd/yy 
AT hh.mm.ss GMT FROM XASRES 
RESTORED TO SCRATCH 
INPUT CYLINDER EXTENTS QUTPUT CYLINDER EXTENTS 


START STOP START STOP 
0000 nnnn 0000 nnnn 
END OF DUMP 


BYTES IN nnnnnnnnnn BYTES OUT nannnnnnnn 
TRACKS NOT COMPACTED ON TAPE - nnnnnnnnnn 


ENTER: 
= 
END OF JOB 
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Wait a few moments for DDRXA to prompt you. 
If a prompt does not appear, press the ENTER 
key. 


This first control statement tells DDRXA that you 
want program messages sent to your console. 


The second control statement is the input control 
statement. vdevno is the virtual address of the 
system residence volume. (The virtual address in 
the sample HCPSYS ASSEMBLE file and USER 
DIRECT ts 123.) devtype is the DASD type of 
this volume. 


This control statement specifies the device to 
which you are dumping the system. 


If your tape drive 1s not operating at 6250 BPI 
density, omit the mode 6250 compact option on 
this command. 


The statement DUMP CPVOL dumps cylinder 0 
and all PERM and DRCT DASD space from the 
system residence volume to the tape. 


These are informational messages. GMT means 
Greenwich Mean Time. 


The exact cylinder extents vary according to the 
device type. 


When DDRXA finishes, it prompts you with 
ENTER. To end the program, press the ENTER 
key. 
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You now have a loadable tape of the system. If you need to use this backup copy to restore CP, perform 
these steps: 


|. Mount the backup tape on a tape drive. 


2. Set your virtual machine to 370-XA architecture, define your virtual storage as 16 megabytes, and IPL 


CMSXA: 


set machine xa @ 
SYSTEM RESET 


SYSTEM = XA 
define storage lém @ 


STORAGE = 16M 


Storage cleared - system reset 
ip! cmsxa Hf 


VM/XA CMS 5.6 mm/dd/yy hh:mm 
a 
SYNONYM SYN 


CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 


. Perform a hardware load (IPL) of the tape device. 
. Use DDRXA to restore the system to disk: 


VM/XA SYSTEM PRODUCT DASD DUMP/RESTORE PROGRAM 


ENTER CARD READER ADDRESS OR CONTROL STATEMENTS 


ENTER: 


sysprint cons @ 
ENTER: 


input rdevno devtype # 
ENTER: 


output rdevno devtype xasres Hl 
ENTER: 


restore all 


RESTORING XASRES 
DATA DUMPED mm/dd/yy 
AT hh.mm.ss GMT FROM XASRES 
RESTORED TO XASRES 
INPUT CYLINDER EXTENTS OUTPUT CYLINDER EXTENTS 
START STOP START STOP 
0000 nnann 0000 nnnn 


END OF RESTORE 
BYTES RESTORED nnnnnnnnnn 


ENTER: 
Bal 


END OF JOB 
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If your machine is already in 370-XA mode, you 
will not get a response. 


This first control statement tells DDRXA that you 
want program messages sent to your console. 


The second control statement Is the input control 
Statement. Identify the device number (rdevno) 
and tape device type (3420, 3422, 3430, or 3480) 
where the backup tape is mounted. 


This control statement specifies the DASD device 
to which you are restoring the system (XASRES). 


The RESTORE ALL statement tells DDRXA to 
restore the whole tape to the output device. 


Informational messages: GMT means Greenwich 


‘Mean Time. 


The exact cylinder extents vary according to the 
device type. 


When DDRXA finishes, it prompts you with 
ENTER. To end the program, press the ENTER 
key. 


Chapter 3. Installing VM/XA System Product Release 2.1 with 
the Starter System (Second Level) 


If you have a first-level VM/XA MA, VM/XA SF, or VM/XA SP system, you can install VM/XA System 
Product as a second-level guest of that system. (For good performance, your first-level system should have at 
least 16 megabytes of storage.) Otherwise, you must install VM/XA System Product as a first-level system. 
See Chapter 2, “Installing VM/XA System Product Release 2.1 with the Starter System (First Level)” on 
page 13 or Chapter 4, “Installing VM/XA System Product Release 2.1 Using an Existing VM/SP or VM/SP 
HPO System” on page 215. 


If your first-level system is VM/XA SP, the first-level user ID you use to install your new system must have 
the privilege classes that are specified on the SERV parameter of the SYSFCN macro in your first-level 
system’s HCPSYS ASSEMBLE file. If this user ID does not have those privilege classes, you will not be able 
to run the Device Support Facilities. 


Step 1. Load the Device Support Facilities 


In this step, you will load the Device Support Facilities (DSF) and use it to initialize and inspect the 
DASD for defective tracks. For more information about the Device Support Facilities, see the Device 
Support Facilities User's Guide and Reference, SC35-0033. 


This step takes approximately 20 to 40 minutes for each DASD volume you inspect, depending on the 
type of DASD. 


The dialogs shown here. are for sample use only. If you find a discrepancy between these dialogs and those 
you have on your terminal, please refer to the Program Directory that you received with the product tape for 
the most current information. 


1. Before you begin, make sure that you have read the information about these steps in Chapter 1, 
“Introduction” on page 3. 


2. Ready the DASD volumes you plan to use. Follow the operation manual for your own hardware. 


If the packs you plan to use for your installation are not already ICKDSF-initialized, you must initialize 
them before proceeding. 


Warning: No volumes with labels XASERV, XAPO01, or XAPO02 should be attached to your system. 
Any such volumes will be brought on line when you IPL the starter system in Step 3. If necessary, you 
can use the Device Support Facilities to relabel your packs. Issue REFORMAT UNIT(vdevno) 
VERIFY (oldlabel) VOLID(newlabel) when DSF prompts you with ENTER INPUT/COMMAND. 


Warning: The addresses of XASRES, XASERV (if used), XAPOO1 (if used), and XAPO02 (if used) must 
match the addresses in the HCPRIO ASSEMBLE file. If the addresses do not match, you will not be 
able to IPL your new system in Step 20. If your addresses are not defined in the sample HCPRIO 
ASSEMBLE file for your DASD type, you will have to tailor it in Step 17. 


3. Attach a tape drive to your user ID. If possible, attach the tape drive at the default virtual address, 
0181. (This is the address used throughout this procedure; if your tape drive has a different virtual 
address, make a note of that address on Table 1 on page 7.) Have the starter system tape mounted on 
the tape drive. 
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4. Issue: 


set machine xa @ If your machine is already in 370-XA mode, you 
SYSTEM RESET will not get a response. 
SYSTEM = XA 
5. Issue: 
ip] vdev clear @ Use the address of the tape drive on which the 


starter system 1s loaded. 


Pause for a short while to allow the IPL to 
complete, then press the ENTER key to create an 


interrupt. 
a 
ICKOO5E DEFINE INPUT DEVICE, REPLY This message tells you that the Device Support 
'DDD,CUU' OR 'CONSOLE' Facilities are loaded and ready. You MUST use 
ENTER INPUT/COMMAND: the Device Support Facilities to format your 
console @ XASRES volume unless it is already formatted. If 
ICKOQ6E DEFINE OUTPUT DEVICE, REPLY XASRES is already formatted, press PAI to exit 
‘DDDD,CUU' OR 'CONSOLE' the Device Support Facilities program and go on 
ENTER INPUT /COMMAND: to Step 2. 
console 


ICKDSF - SA DEVICE SUPPORT FACILITIES 9.0 TIME:hh:mm:ss 
mm/dd/yy PAGE 1 
ENTER INPUT /COMMAND: 


init unit(vdevno) devtype(33xx) novfy val volid(volid) 


vdevno is the address of the DASD volume you 
want to inspect. 33x x is the device type: 3350, 
3375, 3380, or 3390. volid is the volume identifier, 
in this case, XASRES. 


This command requests medial initialization of the 
volume. For maximal or minimal initialization, 
see the Device Support Facilities User's Guide and 
Reference. 


ICKQO700I DEVICE INFORMATION vdevno IS CURRENTLY AS FOLLOWS: 
PHYSICAL DEVICE = 33xx 
STORAGE CONTROLLER = xx 
STORAGE CONTROL DESCRIPTOR = xxxx 
DEVICE DESCRIPTOR = xx 
ICKQO3D REPLY U TO ALTER VOLUME vdevno CONTENTS, ELSE T 
ENTER INPUT/COMMAND 


u @ The system takes 20 to 40 minutes to inspect and 
: reformat the DASD volume. After the DASD 
ENTER INPUT /COMMAND: volume has been reformatted, you receive a series 


of ICK messages that describe the status of the 
device being formatted. 


6. If you want to inspect or format any more DASD volumes, repeat the INIT UNIT command. 
Otherwise, press PAI to go on to Step 2. 
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Step 2. Restore the VM/XA System Product Starter System to Disk 


In this step, you will use the DDRXA utility to restore the starter system to disk. 


This step takes approximately 15 minutes. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


1. Issue: 


ip] vdev clear @ Use the address of the tape drive on which the 
starter system 1s loaded. 


2. Establish an interactive dialog with DDRXA: 
Notes: 


a. When you run DDRXA on a real processor, and you have a nonconsole device at real device number 
0009 or 001F, make sure the device is not operational. Otherwise, results are unpredictable. 
(DDRXA initially assumes that your console has device number 0009 or 001F.) 


b. Also, to prevent inadvertent access to DDRXA, turn off all displays other than the one you will be 
using for DDRXA, so that no one will press the ENTER key on another display and interrupt 
DDRXA while it is waiting for input. 

As soon as you load it into storage, DDRXA begins executing and sends you the following initial 


prompt: 


VM/XA SYSTEM PRODUCT DASD DUMP/RESTORE PROGRAM Pause for a short while to allow the IPL to 
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS complete, then press the ENTER key to create an 
ENTER: interrupt. 


3. Answer the prompting messages from the DDRXA utility: 
Note: The device types for which the following steps are valid include 3350, 3375, 3380, and 3390. 


VM/XA SYSTEM PRODUCT DASD DUMP/RESTORE PROGRAM 
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS 


ENTER: 

sysprint cons Mf This first control statement tells DDRXA that you 
ENTER: want program messages sent to your display. 
input 181 devtype (skip 1 @ The second control statement is the input control 
ENTER: statement. Identify the virtual device address 


(181) and tape device type (3420, 3422, 3430, or 
3480) where the starter system tape is mounted. 
The option skip 1 tells DDRXA to skip over the 
tape mark placed on the tape just before the 
Starter system. 
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output vdevno devtype scratch Hf 
ENTER: 


restore all 


HCPDDR725D SOURCE DASD DEVICE WAS (IS) LARGER 
THAN QUTPUT DEVICE 
DO YOU WISH TO CONTINUE? 
RESPOND YES OR NO: 
yes Hi 


RESTORING XASRES 
DATA DUMPED mm/dd/yy 
AT hh.mm.ss GMT FROM XASRES 
RESTORED TO SCRATCH 
INPUT CYLINDER EXTENTS OUTPUT CYLINDER EXTENTS 
START STOP START STOP 
CCCC CCCC cccc 3=—§.- CCC 
END OF RESTORE 
BYTES RESTORED nnnnnnnnnn 


ENTER: 


= 
END OF JOB 


. Go to CP READ: 


PAI 
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This control statement specifies the virtual address 
and device type of the system residence volume to 
which you are restoring the system (XASRES). 
Specify the device number (vdevno) and device type 
(devtype). Valid devtype values are: 


3350 
3375 
3380 
3390 


The word scratch causes DDRXA not to check the 
label on the volume. 


The RESTORE ALL statement tells DDRXA to 
restore the whole tape to the output device. 


Depending on the DASD model you are using, 
you may or may not see this prompt. If you do 
see it, respond yes. The starter system is designed 
to fit on all supported DASD models. 


Informational messages: GMT means Greenwich 
Mean Time. 


The exact cylinder extents vary according to the 
device type. 


Press ENTER to end the program. 


This entry puts you in first-level CP. Press PAI 
whenever you need to issue a first-level CP 
command. 


Step 3. Load the VM/XA System Product Starter System and Define 
Devices 


In this step, you will: 


e Load the VM/XA System Product starter system 
e Define the devices necessary to perform the system generation. 


Contention for service by the devices on shared control units may result in this step taking a considerably 
longer time than it would when you are installing a first-level system. The step could take as little as 15 
minutes, but may take considerably longer. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


| Local Terminals Only | 


e If you are using local terminals (whose controller is connected to the host computer through a direct 
channel) to do this installation, issue the following commands: 


terminal conmode 3270 @ This command provides full-screen System 
Product Editor (XEDIT) support on your 
second-level terminals. The display units must be 
local non-SNA devices. If you log off or 
disconnect and then log on again, you must reissue 
this command. 


Note: If you receive the message DMKCFTOO6E Invalid device type-, you do not have a local terminal. 
Pee ee End of Local Terminals Only Be 


1. Your first-level system should have at least 16 megabytes of storage: 


define storage l6m 


RESTART POINT 


This is the restart point if you have a failure while building the Starter System at second level. 
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Re-IPLing Your Second-Level System 


If you log off your first-level user ID during this step or any of the remaining steps in this chapter, 
you must reissue the following sequence of first-level commands to reestablish the second-level 
environment before you can re-IPL your second-level system. 


set machine xa Your first-level system must be in XA mode. 


define storage 16M @ Your first-level system should have at least 16 
megabytes of storage. 


term conmode 3276 This command is for local terminals only, and 
provides full-screen XEDIT support on your 
second-level terminals. 


You must also make sure that your.I/O devices are attached to your second-level system and varied 
on. 


2. IPL the XASRES volume: 


ip] vdevno clear vdevno is the first level virtual address of the 
XASRES volume. 

x Pause for a short while to allow the IPL to 
complete, then press the ENTER key to create an 
interrupt. 


Note: If the missing interrupt handler (MIH) is turned on, the following message appears repeatedly: 
5461 Interruption cleared; device devtype, CSW csw, userid userid 
This is not an indication of a problem; the system is operating correctly. 

3. Define your Starter System configuration by answering the following series of prompts. 


The Starter System provides default device addresses and device types. To accept the Starter System 
default for a device prompt, just press the ENTER key. 


IBM recommends that you have a second tape drive to send dumps to when the system is operational. 


You do not need a printer, card reader, punch, or additional graphic device to generate the system. 
However, your system provides a virtual equivalent for each of these devices. If you do not have these 
devices, press ENTER to accept the Starter System defaults. 


If you do not want to accept a Starter System default, enter the address (vdev) or device type (devtype). 
If you supply an address for a device, use the first level virtual address. At second level, this address 
functions as a “real” address. Refer to Table | on page 7 to help you complete this section. 


Whether you accept the Starter System default addresses or define your own, make sure that your 
second-level “real” addresses match your first-level virtual addresses. 


4. Use Table | on page 7 to answer the questions that the VM/XA System Product starter system asks you. 
The following are the starter system’s informational messages and questions: 


Note: If you do not enter values, the system will use its default values. The system default is shown in 
the right-hand column. However, if the system defaults are not in your IOCDS, the system will 
not be able to use those devices. 


DO YOU WISH TO REDEFINE YOUR SYSTEM (YES/NO): 
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yes 


ENTER PRINTER NUMBER (NNNN): 
ei 


If you have not previously defined your system by 
executing this substep. answer yes. If you answer 
no, your starter system may not IPL properly. 


Enter the virtual device number of your printer. 


The system default is OOOE. 


ENTER DEVICE TYPE (1403, 3203, 3211, 3262, 3800, 3800-1, 3800-3, 


4245, 4248): 
x 


ENTER PUNCH NUMBER (NNNN): 
= 


ENTER DEVICE TYPE (2540P,3525): 
a 


ENTER READER NUMBER (NNNN): 
a 


ENTER DEVICE TYPE (2540R, 2501, 3505): 
| 


ENTER NUMBER WHERE FIRST TAPE IS MOUNTED (NNNN): 
S| 


Enter the device type of your printer. The system 
default is 1403. 


Note: 3800 defaults to 3800 Model 1. 


If you press ENTER without typing anything, you 
receive the system default, which is 000D. The 
Starter system does not require a punch actually 
attached to it, but it does create a control block 
for a punch. If you want to use a real punch ata 
virtual device number other than OO0D, type in the 
device number and press ENTER. 


If you press ENTER, you receive the system 
default, which is 2540P. The starter system does 
not require a punch actually attached to it, but it 
does create a control block for a punch. If you 
want to use a punch other than the default, type 
in the device type and press ENTER. 


If you press ENTER, you receive the system 
default. which is 000C. The starter system does 
not require a reader actually attached to it, but it 
does create a control block for a reader. If you 
want to use a real reader at a virtual device 
number other than 000C, type in the device 
number and press ENTER. 


If you press ENTER, you receive the system 
default, which is 2540R. The starter system does 
not require a reader actually attached to it, but it 
does create a control block for a reader. If you 
want to use a reader other than 2540R, type in the 
device type and press ENTER. 


Enter the device number of the tape device where 
the product tape will be mounted. The system 
default is 0580. 
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ENTER DEVICE TYPE (3420, 3422, 3430, 3480): 


devtype @ Enter the device type of your tape drive. The 


system defaults to a device type of 3420. 


ENTER THE NUMBER OF A SECOND TAPE DRIVE (NNNN): 


i ; ; 
You can type in a device number or press 


ENTER, in which case you receive the default 
device number, 0581. The starter system does not 
require a second tape drive actually attached at 
0581 or any other device number; the system does 
create a control block for the device. 


ENTER DEVICE TYPE (3420, 3422, 3430, 3480): 


devtype @ Enter the device type of your second tape drive. 


The system defaults to a device type of 3420. 


ENTER DEVICE NUMBER OF WORK PACK (NNNN): 


- Enter the device number of your second pack 


(XASERV). The system default is 0230. 


This pack is required for all DASD types except 
double- or triple-density 3380 DASD (3380-E4 
and 3380-K) or 3390 DASD. 


ENTER DEVICE TYPE (3350, 3375, 3380, 3390): 


= Enter the device type you are using. 


ENTER NUMBER WHERE EXTRA WORK PACK IS MOUNTED (NNNN): 


_ Enter the device number of your third pack 


(XAPO01). The 3350 and 3375 systems require this 
pack. The 3380 and 3390 systems do not require 
an extra work pack. 


Note: If you do not have XAPO0O1, you will 
receive this message: 
HCPLND1O8E MAINT 0124 NOT LINKED 
when you log on as MAINT. If you are 


using 3380 or 3390 DASD, you can ignore 
this message. 


If you press ENTER, you receive the system 
default, which is 0231. 


ENTER DEVICE TYPE (3350, 3375, 3380, 3390): 


= Enter the device type you are using. 
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i 3350 DASD Only SSSSSSSS* 


ENTER NUMBER WHERE EXTRA WORK PACK IS MOUNTED (NNNN): 


vdevno 


ENTER DEVICE TYPE (3350, 3375, 3380, 3390): 
3356 


Enter the device number of your fourth pack 
(XAP002). The 3350 system requires this pack. 


If you press ENTER, you receive the system 
default, which is 0232. 


[End of 3350 DASD Only _—“—sSSSCSCSCidY 


ENTER NUMBER OF A DISPLAY DEVICE (NNNN): 
vdevno @& 


ENTER DEVICE TYPE (3277, 3278, 3279): 
= 


***SYSTEM DEFINITION COMPLETED*** 
OOOE PRINTER 

Q00D PUNCH 

QO0C READER 

Q580 FIRST TAPE 

0581 SECOND TAPE 

0230 WORK PACK 

Q231 EXTRA WORK PACK 


Q232 OTHER WORK PACK 
rdevno GRAPHIC DEVICE 
ARE THE ABOVE ENTRIES CORRECT (YES, NO): 


yes 


This step allows you to define an additional 
display device. This is not the console you are 
presently using. The system default 1s 021. 


Check your installation’s HCPRIO file to see if 
you have defined this display differently. 


Enter the device type of your display. The system 
default 1s 3278. 


The numbers shown are those that would appear if 
you always take the default. 


You will see this message only if you are using the 
3350 starter system. 


Answer yes to this question. If you respond no, 
the procedure restarts at the first prompt of this 
step. 
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5. The starter system continues: 


VM/XA SYSTEM PRODUCT RELEASE 21 SERVICE LEVEL 0000; 


SYSTEM NUCLEUS CREATED ON mm/dd/yy AT hh:mm:ss, LOADED FROM XASRES 


KKEKKEKRKEKEKKKKEKKEKEKKEKEKKEREKKERKKKEKEKKKRKK 


LICENSED MATERIALS - PROPERTY OF IBM* 


* 
* 
5664-308 (C) COPYRIGHT IBM CORP. 1983, ~* 
1989. ALL RIGHTS RESERVED. . 
US GOVERNMENT USERS RESTRICTED RIGHTS - * 
USE, DUPLICATION OR DISCLOSURE - 
RESTRICTED BY GSA ADP SCHEDULE CONTRACT * 
WITH IBM CORP. . 

* 

* 

* 


* TRADEMARK OF INTERNATIONAL BUSINESS 
MACHINES. 


KHKKKKEKKKKKKKKKKKEEKKEKEKKKEKKRKKEKEKEKKEKEKEEEKEER 


+ £ £€£ ££ £ £€ + ££ FF HF 


HCPISU951I CP VOLID XASERV NOT MOUNTED 
HCPISU951I CP VOLID XAPQO1 NOT MOUNTED 


You may receive the volume not mounted 
messages. 


START ((COLD|WARM|FORCE) (DRAIN) (DISABLE) (NODIRECT) ) | (SHUTDOWN) 


cold drain @ 


NOW hh:mm:ss EST weekday mm/dd/yy 
CHANGE TOD CLOCK (YES|NO) 


no 


THE DIRECTORY ON VOLUME XASRES AT ADDRESS nnnn 
HAS BEEN BROUGHT ONLINE. 
HCPLND1O8E MAINT 0124 NOT LINKED; 
VOLID XAPQO1 NOT MOUNTED 
HCPLND1O8E MAINT 0125 NOT LINKED; 
VOLID XASERV NOT MOUNTED 


HCPLND1O8E MAINT 0126 NOT LINKED; 
VOLID XAPQO2 NOT MOUNTED 

THERE IS NO LOGMSG DATA 

FILES: NO ROR, NO PRT, 

LOGON AT hh:mm:ss EST day mm/dd/yy 


HCPIOP951I CP VOLID volid NOT MOUNTED 


NO PUN 


HCPIOP951I USER VOLID volid NOT MOUNTED 


STORAGE = Q016M 
FILES: 0000001 RDR, Q000001 PRT, NO PUN 
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Because there is no data or accounting 
information to recover, you must request a cold 
Start. 


Answer no. At second level, you do not have 
access to the physical hardware needed to change 
the TOD (Time of day) clock. 


CP logs on the primary system operator (user ID 
MAINT). These are informational messages for 
the real system operator. The FILES message 
refers to spool files; there are no spool files in the 
system, since this is a cold start of the system. 


You will see this message only if you are using the 
3350 starter system. 


You may receive a number of informational 
messages that certain volume identifiers (CP volids 
and user volids) are not mounted. You may 
ignore these messages at this time. 


This message tells you the amount of virtual 
storage available. You must have 16 megabytes. 


6. Initialize CMS and enable all displays: 


VM/XA STARTER SYSTEM The words VM READ appear in the bottom nght 
a corner of the display screen; when VM READ 
SYNONYM SYN appears, press the ENTER key. 


CP TERM MODE VM 


READY; T=n.nn/n.nn hh:mm:ss 


enable all @ This command enables all displays available to 
READY; T=n.nn/n.nn hh:mm:ss your virtual machine. The VM/XA System 
Product logo appears on all enabled displays. 


7. Spool MAINT’s console: 


spool cons * start This command creates a spool file of all display 

READY; T=n.nn/n.nn hh:mm:ss output for the MAINT virtual machine. Spooling 
MAINT’s console can be valuable 1f problems 
arise and you want to review the system 
generation activity. If you issue this command, 
you will have a record of this activity. When you 
close the file (SPOOL CONS CLOSE) or log off, 
the file is automatically sent to your reader. 


8. Set the dump to a tape drive or printer address. It is recommended that you use the second tape drive 
you defined for sending dumps to. If you use a tape drive, mount a scratch tape with a ring on the drive. 


set dump vdevno @ Replace the vdevno with the virtual device number 


{TAPE | PRINTER} devno DUMP UNIT CP IPL of your tape drive or printer to free up some of 
the spool space. 


Warning: If you do not perform this step, you may run out of SPOOL space later on. In the event of a 
SHUTDOWN and restart at any time during this install procedure, you should perform this substep 
again. 


Stopping and Restarting the Installation 


From this point on, when installing VM/XA SP at second level, you can stop the installation after the 
completion of any step by issuing the following command to disconnect your first-level user ID: 


PAL 
#cp disconnect @ 


To restart, log on again to your first-level user ID and issue the following commands: 


terminal conmode 3270 M (local terminals only) 
begin @ 


This puts you back where you were when you stopped. 
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Step 4. Attach the VM/XA System Product Release 2.1 Product Tape 
(Volume 1) and Load the First Three Files 


In this step, you will: 


e Mount Volume | of the VM/XA System Product product tape on a tape drive 
e Attach the product tape drive to MAINT 
e Load the first three files from the product tape. 


This step takes approximately 5 minutes. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


1. Mount volume | of the VM/XA System Product product tape (in write-protect mode) on the tape drive 
that you specified as the first tape in “Step 3. Load the VM/XA System Product Starter System and 
Define Devices” on page 117. Follow the operation manual for the machine on which you mount the 
tape. 


2. Attach the tape drive to MAINT at virtual device number 0181: 


attach vdevno * 181 The ATTACH command attaches the virtual 
TAPE vdevno ATTACHED TO MAINT 0181 device (vdevno) to MAINT’s virtual machine at 
READY; T=n.nn/n.nn hh:mm:ss virtual device number 0181. 


3. Check MAINT’s disk accesses. Be sure MAINT ’s 191 minidisk is the A disk. 


query search @ The QUERY SEARCH command tells you what 
MNT191 191 A R/W disks you have accessed and the alphabetic order 
MNT190 190 S R/0 of those accesses. When searching for files, CMS 
READY; T=n.nn/n.nn hh:mm:ss uses the alphabetic order of accesses to create a 


search order. CMS searches the A minidisk, if 
accessed, then the B minidisk, if accessed, and so 
forth. 


4. If MAINT’s 191 minidisk is not A, access that minidisk as A: 


access 191 a This message would appear if the QUERY 
191 REPLACES A (195) SEARCH command had shown MNT195 195 A 
READY; T=n.nn/n.nn hh:mm:ss R/W. 


5. For your own convenience, set PF12 as a retrieve key. When you press the retrieve key, the last 
instruction you issued will be displayed. You need only press ENTER to enter it again. 


set pfl2 retrieve @ You may add this command to your PROFILE 
Ready; T=n.nn/n.nn hh:mm:ss EXEC. 
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To Speed Up the Installation Procedure 


Creating a PROFILE EXEC and a PROFILE XEDIT file at this time can save you time in 

subsequent installation steps. You can set up PF key assignments in your PROFILE EXEC to save 
keystrokes. You can create a PROFILE XEDIT to present the XEDIT screen to your liking instead 
of taking the default XEDIT assignments provided by IBM. 


6. Use the VMFPLC2 LOAD command to load the first three files (the tape header, memos, and 
installation tools) from the product tape to your A-disk: 


vmfplc2 load (eof 3 This command loads the first three tape files from 
LOADING..... the product tape. (A tape file is the set of files 
$TAPE$ HEADER Al between two tape marks.) These are the only tape 
END-OF-FILE OR END-OF-TAPE files you have to load—the ITASK EXEC 


automatically loads the rest of the tape. You will 
receive a message from VMFPLC2 telling you 
which files it loaded. 


SUPSP21 MEMO Al The VMSUP memo 1s loaded to the MAINT 191 
56643089 SERVICE Al minidisk. Read this memo before going on. 


END-OF-FILE OR END-OF-TAPE After you perform Step 8, you may wish to copy 


SUPSP21 MEMO to the CP BASE disk (194 or 
394) to free space on MAINT 191. 


56643089 $PPF Al The tools in the third file are installation EXECs. 
RPWLIST DATA Al You may erase them after you finish the 
$MSG4I$ EXCAMENG Al installation, except for these files: 


$$RDPW$$ EXEC Al 
$MSG41$ EXEC Al 
SETUP EXEC Al 
SPLOAD EXEC Al e SETUP EXEC, which must remain on the 
UTILITY EXEC Al MAINT 191 minidisk. 


cle ene e The DIRECTXA MODULE is loaded to MAINT 
DIRECTXA MODULE A2 ; 
191 now so that you can bring your directory 
DVM PROFILE Al ie eine 
online in Step 5. It is erased after it is used, then 
SPLOAD PROFILE Al 
END-OF-FILE OR END-OF-TAPE reloaded to MAINT 190 in Step 8. If you need to 
reissue ITASK ALLOCATE, you must rewind the 
tape and issue VMFPLC2 LOAD DIRECTXA 
MODULE A (EOT to reload the DIRECTXA 
MODULE from Volume | of the product tape. 


¢ DIRECTXA MODULE, which is erased 
during the installation procedure 


Chapter 3. Installing VM/XA System Product Release 2.1 with the Starter System (Second Level) 125 


Step 5. Invoke the ITASK EXEC 


In this step, you will use the ITASK EXEC to: 


e Provide a password for user IDs MAINT and OPERATOR 
e Load the system samples and the sample user directory 
¢ Format the XASERV, XAPOOI1, and XAP002 volumes. 


The time for this step depends upon the devices involved. It usually takes at least 30 minutes for each 
pack you format. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


Note: A description of the ITASK EXEC and its operands can be found in “ITASK EXEC” on page 611. 


Warning: To do the load, ITASK EXEC issues the COPYFILE command with the REPLACE option. This 
command overwrites any files already on the disk that have the same labels as the sample files being copied 
to it. If you are redoing this step, and you have already tailored some of the sample files, you may want to 
rename the files that you tailored before you invoke ITASK. 


Warning: The ITASK EXEC cannot handle virtual DASD that are defined with different physical 
characteristics from the real DASD. Consider this restriction when you define the virtual DASD used in the 
installation procedure. For example, do not define a real double-density 3380 as two virtual single-density 
3380s. 


Note: Do this step while logged on as the MAINT user ID. 
1. Make your DASD volumes available for use; issue the following command for each volume except 


XASRES: 


vary online vdevno Hi vdevno is the first-level virtual address of the 
volume; this address functions as a “real” address 
at second level. 


2. Issue ITASK ALLOCATE to supply a password for MAINT and OPERATOR and to format the 
XASERV, XAPO0I, and XAP002 volumes: 


Note: The example in this manual uses a 3380 DASD for the minidisks. If you use a 3350, 3375, 
3380-E4, 3380-K, or 3390, your space allocations and starting address for CMS will differ. 


itask allocate EH 


REWIND COMPLETE These are informational messages to tell you how 
DMSACC724I 191 REPLACES A (191) the operation is progressing. xx 1s 50, 75, 80, 8E, 
REWIND COMPLETE 83, 90, or 91, according to your DASD type. 


DMSWTK409I LOADING 33xx * TO 191 
ATTACHED TO MAINT 


Note: If ITASK exits with return code 1040, the 123 full-pack minidisk is not attached. The virtual 
address of XASRES is 123. You may have to reattach XASRES to your system. 
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3. When prompted, enter a new password to be used as both your MAINT and OPERATOR passwords: 


ENTER ONE PASSWORD FOR MAINT AND OPERATOR: 


password @ 


ENTER PASSWORD AGAIN TO VERIFY: 


password @ 


VM/XA SYSTEM PRODUCT USER DIRECTORY 
CREATION PROGRAM - RELEASE 2.1 
EQJ DIRECTORY UPDATED AND ON LINE 
DMSWSL970I FORMATTING MAINT 193 MINIDISK 
DMSWSL409I LOADING SYSGEN TOOLS TO 
THE 193 DISK ATTACHED TO MAINT 


DMSWSL970I FORMATTING MAINT 295 MINIDISK 
DMSWSL409I LOADING HCPSYSxx * TO 

THE 295 DISK ATTACHED TO MAINT 
DMSWSL4091 LOADING HCPRIOXA * TO 

THE 295 DISK ATTACHED TO MAINT 
DMSWSL4091 LOADING HCPBOX * TO 

THE 295 DISK ATTACHED TO MAINT 
DMSWSL970I FORMATTING MAINT 395 MINIDISK 
DMSWSL409I LOADING CMSLOC SAMPLES T0 

THE 395 DISK ATTACHED TO MAINT 
DMSACC724I 191 REPLACES A (191) 


DMSWTK965I YOU MAY WISH TO TAILOR THE FOLLOWING 
FILES BEFORE NUCLEI GENERATION: 


HCPRIO ASSEMBLE 
HCPBOX ASSEMBLE 
HCPSYS ASSEMBLE 
DMSNGP ASSEMBLE 
USER DIRECT 


You must supply a single password to be used for 
both the MAINT and OPERATOR user IDs. 

The ITASK EXEC will XEDIT the user directory 
and replace NOLOG with the logon password that 
you provide here. 


When selecting a password, refer to the RPWLIST 
DATA file shown in Appendix F, “Restricted 
Logon Passwords” on page 859. This file 
contains all of the restricted passwords for your 
VM/XA SP2.1 system. You cannot choose a 
password for MAINT and OPERATOR that 
exists in this file. 


Reenter the password that you have designated for 
the MAINT and OPERATOR user [Ds. 


YOU NEED TO REMEMBER THIS 
PASSWORD FOR USE IN LATER STEPS. 
You can write it down on the worksheet—see 
Table 1 on page 7. 


These first messages signify that the user directory 
has been created. Then ITASK loads the system 
generation tools needed next. 


These are messages from ITASK as it loads files 
from the product tape. The time the ITASK 
EXEC needs to execute varies from system to 
system. 


You will be able to tailor HCPRIO ASSEMBLE, 
HCPBOX ASSEMBLE, and HCPSYS 
ASSEMBLE in “Step 17. Tailor the Sample 
HCPRIO, HCPSYS, HCPBOX Files and the 
Product Parameter File” on page 158. You will 
tailor DMSNGP ASSEMBLE in “Step 14. Tailor 
the DMSNGP Profile” on page 148. You will 
tailor USER DIRECT in “Step 21. Update the 
User Directory” on page 172. 


DMSWTK981I WHAT IS THE REAL ADDRESS OF YOUR XASERV VOLUME? 


DMSWTK982T TYPE: REAL ADDRESS OR SKIP 
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vdevno or skip @ Enter the virtual address, vdevno, of the XASERV 
volume. Remember that the virtual address 
functions as a real address at second level. Refer 
to your worksheet (Table | on page 7) for the 
label and address of this system volume. Check 
that you typed the right address before you press 
ENTER. 


If you do not want to use XASERV, or if you 
have already formatted it, enter skip. 


DASD vdevno ATTACHED TO MAINT 301 


CPFMT XA: 
FORMAT WILL ERASE CYLINDERS 0000-nnnn ON DISK 301 
DO YOU WANT TO CONTINUE ? (YES | NO) You need not answer; the EXEC answers YES. 


FORMAT IN PROGRESS ON DISK 301 
CYLINDERS 0 THROUGH 49 FORMATTED 


CYLINDERS nnnn THROUGH nnnn FORMATTED 


FORMAT COMPLETE This message signifies that CPFMTXA has 
CURRENT ALLOCATION completed formatting the XASERV volume. 
TYPE CYLINDERS 

PERM 0000-nnnn 

ENTER ALLOCATION DATA 

TYPE CYLINDERS 

CURRENT ALLOCATION 

TYPE CYLINDERS 

PERM 0000-nnnn 

ALLOCATE COMPLETE 

VOLUME LABEL IS NOW 'XASERV' 


HCPFAM384I CPFMTXA COMPLETE The HCPFAM384I message signals the 
DASD vdevno DETACHED MAINT 0301 completion of this sequence. 
DASD vdevno ATTACHED TO SYSTEM XASERV 


DMSWTK981I WHAT IS THE REAL ADDRESS OF YOUR XAPOQO1 VOLUME? 
DMSWTK982I TYPE: REAL ADDRESS OR SKIP 


vdevno or skip Enter the virtual address, vdevno, to allocate the 
DASD vdevno ATTACHED TO MAINT 302 XAPOOQ!] volume. Check that you typed the right 
CPFMTXA: address before you press ENTER. 


FORMAT WILL ERASE CYLINDERS 0000-nnnn ON DISK 302 As 3350 and 3375 staviereysieme require 


XAPOOI. Refer to your worksheet (Table | on 
page 7) for the label and address of this system 
volume. 


If you do not want to use XAPOO1I, or 1f you have 
already formatted it, enter skip. 


DO YOU WANT TO CONTINUE ? (YES | NO) You need not answer; the EXEC answers YES. 
FORMAT IN PROGRESS ON DISK 302 
CYLINDERS 0 THROUGH 49 FORMATTED 
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FORMAT COMPLETE This message signifies that CPFMTXA has 
CURRENT ALLOCATION completed formatting the XAPOO! volume. 
TYPE CYLINDERS 

PERM 0000-nnnn 

ENTER ALLOCATION DATA 

TYPE CYLINDERS 

CURRENT ALLOCATION 

TYPE CYLINDERS 

PERM 0000-nnnn 

ALLOCATE COMPLETE 

VOLUME LABEL IS NOW 'XAPQQ1' 


HCPFAM384I CPFMTXA COMPLETE The HCPFAM384I message signals the 
DASD vdevno DETACHED MAINT 0302 completion of this sequence. 
DASD vdevno ATTACHED TO SYSTEM XAPOO1 


| 3350 DASD Only | 


DMSWTK9811I WHAT IS THE REAL ADDRESS OF YOUR XAPOQ02 VOLUME? 
DMSWTK9821 TYPE: REAL ADDRESS OR SKIP 


vdevno or skip & Enter the virtual address, vdevno, to allocate the 
DASD vdevno ATTACHED TO MAINT 303 XAPO002 volume. The 3350 starter system requires 
CPFMTXA: XAPO02. Refer to your worksheet (Table | on 


FORMAT WILL ERASE CYLINDERS 0000-nnnn ON DISK 303 page 7) for the label and address of this system 
volume. Check that you typed the right address 
before you press ENTER. 


If you have already formatted XAPO002, enter skip. 


DO YOU WANT TO CONTINUE ? (YES | NO) You need not answer; the EXEC answers YES. 
FORMAT IN PROGRESS ON DISK 303 
CYLINDERS @ THROUGH 49 FORMATTED 


FORMAT COMPLETE This message signifies that CPFMTXA has 
CURRENT ALLOCATION completed formatting the XAP002 volume. 
TYPE CYLINDERS 

PERM Q000-nnnn 

ENTER ALLOCATION DATA 

TYPE CYLINDERS 

CURRENT ALLOCATION 

TYPE CYLINDERS 

PERM 0000-nnnn 

ALLOCATE COMPLETE 

VOLUME LABEL IS NOW 'XAPOO2' 
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HCPFAM384I CPFMTXA COMPLETE The HCPFAM384I message signals the 
DASD vdevno DETACHED MAINT 0303 completion of this sequence. 
DASD vdevno ATTACHED TO SYSTEM XAPO02 


Po End 0f 3350 DASD Only —C—CSCSCSYCt 


READY; T=n.nn/n.nn hh:mm:ss This message tells you that the ITASK EXEC has 
completed the sequence for each volume needed 
for installing VM/XA System Product Release 2.1. 
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Step 6. Format the Remaining Base CP Minidisks 


In this step, you will use the ITASK EXEC to format the remaining minidisks that are defined in the CP 
directory, but have not yet been formatted or loaded in a previous step. ITASK also puts a PROFILE 
EXEC on the 191 minidisk for EREP and DISKACNT. 


The time to perform this step may vary, but a good estimate is 45 minutes. 


1. Use the ITASK EXEC with the BASEIDS parameter to format, load, and add (as appropriate) 
PROFILE EXECs to the remaining minidisks in the base CP directory. If you issue ITASK BASEIDS 
from a user ID other than MAINT, it will format that user ID’s minidisks instead of MAINT’s. 


Note: The block sizes of the 190 and 490 minidisks have increased from 1K B to 4KB for minidisk 
caching. The Starter System defines the 190 and 191 minidisks (formatting the 19] disk with a 
1KB block size), while the ITASK BASEIDS step formats all other minidisks with a 2KB block 
size. 


If you choose to format a minidisk with a block size of 4K B. the number of cylinders for that minidisk 
may have to be increased, as is the case for the HELP disks. 


itask baseids @ 
DMSWTK1310I DO YOU WANT TO FORMAT MINIDISKS: 
AUTOLOG1 (191), CMSBATCH (195), DISKACNT (191), 
MAINT 36E (PVM), EREP (191), AND OPERATNS (191)? 
DMSWTK8005R TYPE: 1 (YES) OR O (NO). 
1 


DMSWTK968I THE FOLLOWING MINIDISKS 
DEFINED IN THE BASE CP DIRECTORY 
WILL BE FORMATTED: 


MAINT 292 MAINT 49C 
MAINT 194 MAINT 49D 
MAINT 19C MAINT 501 
MAINT 19D MAINT 591 
MAINT 19E MAINT 592 
MAINT 201 MAINT 593 
MAINT 291 MAINT 594 
MAINT 293 MAINT 595 
MAINT 294 MAINT 596 
MAINT 391 MAINT 59E 
MAINT 392 MAINT 5E5 
MAINT 393 MAINT 691 
MAINT 394 MAINT 692 
MAINT 423 MAINT 791 
MAINT 490 MAINT 892 
MAINT 49] MAINT 895 
MAINT 492 MAINT 896 
MAINT 495 MAINT 89E 


DMSWTK9701 FORMATTING AUTOLOG1 191 MINIDISK 
DMSWTK970I FORMATTING CMSBATCH 195 MINIDISK 
DMSWTK970I FORMATTING DISKACNT 191 MINIDISK 
DMSWTK969I A PROFILE EXEC HAS SUCCESSFULLY 
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BEEN 
DMSWTK9701 
DMSWTK9691 

BEEN 
DMSWTK9701 
DMSWTK970I 
DMSWTK970I 
DMSWTK970I 
OMSWTK9701 
DMSWTK9701 
DMSWTK97601 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK970I 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK970I 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701I 
DMSWTK9701 
DMSWTK970I 
OMSWTK9701 
DMSWTK9701 
DMSWTK970I 
DMSWTK9701 
DMSWTK9701 
DMSWTK970I 
DOMSWTK970I 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 


COPIED TO DISKACNT'S 191 MINIDISK 


FORMATTING EREP 191 MINIDISK 


A PROFILE EXEC HAS SUCCESSFULLY 


COPIED TO EREP'S 191 MINIDISK 
FORMATTING MAINT 36€ MINIDISK 


FORMATTING OPERATNS 191 MINIDISK 


FORMATTING MAINT 292 MINIDISK 
FORMATTING MAINT 194 MINIDISK 
FORMATTING MAINT 19C MINIDISK 
FORMATTING MAINT 19D MINIDISK 
FORMATTING MAINT 19E MINIDISK 
FORMATTING MAINT 201 MINIDISK 
FORMATTING MAINT 291 MINIDISK 
FORMATTING MAINT 293 MINIDISK 
FORMATTING MAINT 294 MINIDISK 
FORMATTING MAINT 391 MINIDISK 
FORMATTING MAINT 392 MINIDISK 
FORMATTING MAINT 393 MINIDISK 
FORMATTING MAINT 394 MINIDISK 
FORMATTING MAINT 423 MINIDISK 
FORMATTING MAINT 490 MINIDISK 
FORMATTING MAINT 491 MINIDISK 
FORMATTING MAINT 492 MINIDISK 
FORMATTING MAINT 495 MINIDISK 
FORMATTING MAINT 49C MINIDISK 
FORMATTING MAINT 49D MINIDISK 
FORMATTING MAINT 501 MINIDISK 
FORMATTING MAINT 591 MINIDISK 
FORMATTING MAINT 592 MINIDISK 
FORMATTING MAINT 593 MINIDISK 
FORMATTING MAINT 594 MINIDISK 
FORMATTING MAINT 595 MINIDISK 
FORMATTING MAINT 596 MINIDISK 
FORMATTING MAINT 59E MINIDISK 
FORMATTING MAINT 5E5 MINIDISK 
FORMATTING MAINT 691 MINIDISK 
FORMATTING MAINT 692 MINIDISK 
FORMATTING MAINT 791 MINIDISK 
FORMATTING MAINT 892 MINIDISK 
FORMATTING MAINT 895 MINIDISK 
FORMATTING MAINT 896 MINIDISK 
FORMATTING MAINT 89E MINIDISK 


DASD 333 DETACHED 


READY; T=n.nn/n.nn hh:mm:ss The ready message indicates that ITASK has 


completed its work successfully. 


2. If any of the minidisks listed in message DMSWTK968I were not formatted, check your work packs to 
make sure that they are labeled XASERV, XAPOOI, and XAPO002, and that they are attached to the 
system. Then reissue ITASK BASEIDS. 


3. Continue with the next step. 
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Step 7. ITASK Loads Files from the Product Tape (Volume 1) 


In this step, you will issue the ITASK EXEC to load files from Volume | of the product tape. 


This step takes approximately 30 minutes. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


1. Enter the ITASK command with the LOAD ALL] operands to load the CP and dump viewing facility 
object code and service files. If a problem should occur during this step, or for if some reason you want 
to return to this step and load product tape files, see “ITASK EXEC” on page 611 for instructions on 
loading the files you need. 


itask load alll @ 
DMSWSL409I LOADING SYSTEM SAMPLES TO 

THE 191 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CP OBJECT TO 

THE 194 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CP PUTAPPLY TO 

THE 292 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CP PUTDELTA TO 

THE 294 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CP CORAPPLY TO 

THE 292 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CP CORDELTA TO 

THE 294 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING DUMPVIEW OBJECT TO 

THE 193 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING DUMPVIEW PUTAPPLY TO 

THE 392 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING DUMPVIEW PUTDELTA TO 

THE 293 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING DUMPVIEW CORAPPLY TO 

THE 392 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING DUMPVIEW CORDELTA TO 

THE 293 DISK ATTACHED TO MAINT 
READY; T=n.nn/n.nn hh:mm:ss 


These are messages from ITASK as it loads more 
files from the product tape. The time the ITASK 
EXEC needs to execute vanes from system to 
system. 
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Step 8. ITASK Loads Files from the Product Tape (Volume 2) 


In this step, you will issue the ITASK EXEC to load files from Volume 2 of the product tape. 


This step takes approximately 30 minutes. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


1. Mount Volume 2 of the product tape. 


2. Issue ITASK LOAD CMS to load the CMS object code, source code, and service files and the IOCP 
files: 


itask load cms @ 
DMSWSL409I LOADING CMS BASE TO 
THE 193 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING IOCP: FILES TO 
THE 193 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CMS PUTAPPLY TO 
THE 392 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CMS PUTDELTA TO 
THE 293 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CMS CORAPPLY TO 
THE 392 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CMS CORDELTA TO 
THE 293 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING CMS SYSTEM TO 
THE 190 DISK ATTACHED TO MAINT 


3. The ITASK EXEC invokes the SETUP EXEC to establish the minidisk access order, then the 
ASMGEND EXEC to build the system F assembler and create the associated auxiliary directory: 


DMSACC724I 191 REPLACES A (191) 


DMSACC724I 190 REPLACES A (191) 

DMSACC725I 190 ALSO = S DISK 

ASSEMBLE XF GEND PROC 

ENTER TARGET DISK MODE FOR ASSEMBLE MODULES 
DEFAULTS TO S-DISK IF NONE ENTERED. 


a Press ENTER to place the modules on the S-disk, 
the system default. 


Enter another disk-mode letter if you prefer the 
modules to be placed on another minidisk. 


ASSEMBLE XF GEND COMPLETE 


DMSACC7241I 191 REPLACES A (190) 
READY; T=n.nn/n.nn hh:mm:ss 
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Notes: 


a. At this time, you may choose to make a copy of the documentation file (SSUPSP21 MEMO) to the 
CP BASE disk as suggested in Step 4, substep 6 on page 125. 


b. You may choose to load HELP files, CP, CMS, and dump viewing facility source files, and GCS 
object files at this time. The following is an alternative order for loading these files that will 
minimize tape mounts: 


1) Load HELP files from Volume 2. (See Step 22 on page 173.) 
2) Load GCS object files from Volume 2. (See Step 26, substep 3 on page 179.) 


3) Load CP, CMS, and dump viewing facility source files from Volume 3. (See Step 23 on page 
174.) 
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Step 9. Establish the Service Tools Build Disk 


In this step, you will copy the latest level of the service tools to the service tools build disk. 


This step takes approximately 10 to 15 minutes. 


To be sure that you are using the most recent service EXECs, you must have the latest level of service on a 
service tools build disk. This disk, 5E5, is defined in the sample directories. It is the only disk in the TASK 
string in the product parameter file. 


l. 


bo 


IPL 190: 
ip] 190 clear @ 
VM/XA STARTER SYSTEM 
| 
SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 
. Establish the correct minidisk access order and create a work EXEC to help you copy the service tools: 
setup i 
Ready; T=n.nn/n.nn hh:mm:ss 
DMSACC724I vdevno replaces fm (vdevno 
vmfsetup 56643089 cms Hf 
DMSACC724I vdevno replaces fm (vdevno 
Ready; T=n.nn/n.nn hh:mm:ss 
xedit Ivlses exec fm Hf fms the filemode of the task disk (SES). 
input @ 
&TRACE OFF Enter these lines exactly as they appear. 


&FT = &LEFT OF &2 2 
&FT = &CONCAT OF &FT * 
EXEC FILELIST &1 &FT * 


SEXIT 0 

wi Press ENTER twice to return to the command 
al line. 

file i 


. Look for the latest version of the CPYSVSES EXEC or CPYSVSES EXCnnnnn. CPYSVSES contains a 


list of all the service EXECs. 


filelist cpysvses * * Examine each version of CPYSVSES. CPYSVSES 
has an update history at the top. The latest level 
is one with the most updates. Use the update 
history, not the date and time stamp, to determine 
which is the most recent version. 
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| 4. Copy the latest level of CPYSVSES to the task disk (SES) with a filetype of EXEC: 


copyfile / = exec fm (olddate replace @ Issue this command from the FILELIST screen, 
| Ready; T=n.nn/n.nn hh:mm:ss on the line listing the file you want to copy. 


| 5. Invoke CPYSVSES EXEC: 


cpysvses exec lvises 
| Ready; T=n.nn/n.nn hh:mm:ss 


| 6, CPYSVSES EXEC invokes LVLSES, which invokes FILELIST to display each entry for each service 
| EXEC listed in CPYSVSES. Process each FILELIST screen as follows: 


| a. For each of the files on the FILELIST screen, determine which is the latest version. Do not depend 

| on the date and time stamps; examine the actual files. Each file ends with an update summary that 

| indicates the file’s service history. The latest version is the one with the most service. Files with 

| filetypes of EXCnannnn, MODnannn, XEDnnnnn, and PRFnnnnn are exact images of the 
corresponding EXEC, MODULE, XEDIT, and PROFILE executables. 


| b. Copy the latest files to the task disk (SE5), using the OLDDATE REPLACE options. Assign the 
| copy a filetype of EXEC. MODULE, XEDIT, or PROFILE: 


| copyfile / = ft fm (olddate replace @ Issue this command from the FILELIST screen, 
| on the line listing the file you want to copy. 


| c. Press PF3 to exit this FILELIST screen and go to the next screen. 
| d. Continue until there are no more FILELIST screens. 


| 7. Look for the latest version of the product parameter file: 


| filelist 56643089 * * Examine each version of the product parameter 

! file. A sample product parameter file is shown in 
“A Sample Product Parameter File” on page 384. 
The product parameter file has an update history 

| at the top. The latest level is the one with the 

| most updates. Use the update history, not the date 

| and time stamp, to determine which is the most 

| recent version. 


8. Copy the latest level of the product parameter file to the task disk (5E5): 


copyfile / = $ppf fm (olddate replace @ Issue this command from the FILELIST screen, 
Ready; T=n.nn/n.nn hh:mm:ss on the line listing the file you want to copy. 


_ 9. Now that the service tools are all on the service tools build disk, you do not need to issue SETUP again. 
| Instead, simply access 5ES as B. You may wish to add this access to MAINT’s PROFILE EXEC. 


| access 565 b Ml 
| Ready; T=n.nn/n.nn hh:mm:ss 
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| 


10. 
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Check MAINT 191 (your A-disk) for files with the same filename as files on the task disk (5E5). Erase 


any duplicate files from the MAINT 191 (your A-disk) so that you will not invoke any back-level service 
EXECs. 


filelist * * b This command lists all the files on your B-disk. 


PF9 Pressing PF9 on the FILELIST screen lists all the 
files with the same filename as the one where the 
cursor iS positioned, with any filetype and on all 


disks. See if there is one with the same filename 
on the A-disk. 


erase Enter this command on the line listing the file you 
want to erase. Be sure to erase the file only on the 
A-disk (191), not on the B-disk (5E5) or any other 
disk on which it may appear. 
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Step 10. Set the System Default National Language 


In this step, you will set the system default national language. 


This step takes approximately 20 minutes. 


The system default national language is mixed-case American English. This means that most system 
messages and HELP files will appear in mixed case (capital and small letters). Some will appear in uppercase 
(capital letters only). 


Decide whether you want to keep the system default as mixed-case American English or change it to 
uppercase American English (in which case all system messages and HELP files will be in uppercase). Follow 
the appropriate instructions below. 


If you want to install a system default national language other than American English, you will be able to do 
so after you finish the installation process. See Chapter 5, “Installing a New System National Language” on 
page 311 for instructions. 


If you want to install an alternate system national language (including whichever version of American English 
is not your default), see VM/XA SP Planning and Administration. 


Mixed-Case American English 


If you want to keep the system default national language as mixed-case American English, you should 
convert the installation messages to mixed case. (If you do not do so, all the installation messages will 
continue to appear in uppercase, but most other system messages will appear in mixed case.) 


1. Save the uppercase installation message file: 


rename $msg4i$ exec a = excuceng = Mf 
READY; T=n.nn/n.nn hh:mm:ss 


2. Rename the mixed-case installation message file: 


rename $msg4i$ excameng a = exec = Ml 
READY; T=n.nn/n.nn hh:mm:ss 


Notes: 
1. You may see the following message when you IPL CMS: 


DMSINS283E The NLSAMENG saved segment could not be found; 
return code 44 from SEGMENT 


This is an informational message. You can ignore it. 


2. If you receive service for $MSG4I$ EXEC, the service will be in uppercase. You do not have to convert 
it to mixed case. 


Chapter 3. Installing VM/XA System Product Release 2.1 with the Starter System (Second Level) 139 


Uppercase American English 


If you want to change the system default to uppercase American English, you must: 


l. 


tv 


Edit the product parameter file and change all :NLS. tags from AMENG to UCENG: 


xedit 56643089 $ppf @ 


ch/:NLS. AMENG/:NLS. UCENG/* * @ There are six blanks after :NLS. in the XEDIT 
file & change command. 


Save DMSNGP TEXT, then rename the DMSNGP TXTUCENG file DMSNGP TEXT. This gives you 
a TEXT file assembled from a DMSNGP profile with LANGID = UCENG and HELP=19C. 


Note: You will be able to make other changes in the DMSNGP profile in Step 14, after you install 
Assembler H. You will have to change the LANGID= and HELP= parameters in Step 14. The 
DMSNGP TXTUCENG file is provided here only to allow you to specify uppercase American 
English as your system default national language. 


access 395 d 
DMSACC724I 395 REPLACES D(395) 
READY; T=n.nn/n.nn hh:mm:ss 


rename dmsngp text d = txtameng = 
READY; T=n.nn/n.nn hh:mm:ss 
rename dmsngp txtuceng d = text = & 


READY; T=n.nn/n.nn hh:mm:ss 


. Convert SVMFMSG$ EXEC (the service message file) to uppercase: 


xedit $vmfmsg$ exec 
uppercas * Hi 
file Hf 


Notes: 


l. 


You may see the following message when you IPL CMS: 


DMSINS283E The NLSUCENG saved segment could not be found; 
return code 44 from SEGMENT 


This is an informational message. You can ignore It. 


2. If you receive service for SVMFMSG$ EXEC, the service will be in mixed case. You will have to 


convert it to uppercase. If you receive service for the DMSNGP profile or the product parameter file, 
you will have to update them again. 
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Step 11. Build CMS 


In this step, you will build CMS. 


This step takes approximately 5 minutes. 


1. IPL 190 and issue ITASK BUILD CMS to invoke the CMS BUILD process: 


ip] 199 clear @ 


VM/XA STARTER SYSTEM 
a 


SYNONYM SYN 
CP TERM MODE VM 
READY; T=n.nn/n.nn hh:mm:ss 


spool punch * 
Ready; T=n.nn/n.nn hh:mm:ss 


itask build cms B 
nnnnnnnn files changed 


DMSACC7241 191 replaces A(191) 
DMSACC7241 5E5 replaces B(5E5) 


DMSWSU1900W The existing 56643089 $SETUP Al 
file has been refreshed. You 
might want to check your access 
order when done. 


LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


RDR FILE fileno SENT FROM MAINT PUN AS fileno 
RECS nnnk COPY 001 NOHOLD NOKEEP 


DMSWSU1906E The access of 19E failed with a 
return code of 28. Processing 
stops for product 56643089. 
The original access order cannot 
be restored. 


Ready; T=n.nn/n.nn hh:mm:ss 


ITASK invokes the SETUP EXEC to create the 
correct CMS access order. 


You will see this message only if you have a copy 
of 56643089 $SETUP on your A-disk. If you do 
see it, you will get return code 4. 


A temporary load list is created and the system 
loader is invoked. 


The CMS nucleus has been sent to your reader. 


You may receive this message. It is not a 
problem. The access failed because 19E is empty. 
You will reaccess 19E when you re-IPL 190. If 
you see this message, you will get return code 4. 


If you get return code 4, the reason may be that a 
PTF now being applied has another PTF, outside 
CMS, as a prerequisite. Check the }VMFBLD 
SERRLOG file for message DMSBNC1854W. 


. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build @ 
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3. Ensure that the proper files are in MAINT’s virtual reader: 


query rdr maint all @ The ALL operand requests a display of all 
information about the reader files. 

ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT nonn * PUN nannnnnn 001 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 


Ready; T=n.nn/n.nn hh:mm:ss 
This is the file that you will IPL in substep 7 
below. It has approximately 28,000 records. The 
exact size varies according to the system default 
language, local modifications, and VMSUP level. 


4. Order your reader so that the CMS nucleus will be processed first: 


order rdr fileno @ fileno is the file number of the CMS nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


5. Ensure that the virtual reader is readied for class * reader files: 


query virtual 00c HB 

RDR @Q00C CL cl NOCONT NOHOLD EOF READY 
OQ0C 2540 CLOSED KEEP 

Ready; T=n.nn/n.nn hh:mm:ss 


6. If the virtual reader is not class *, issue: 


spool rdr class * keep M@ The KEEP option places the spool file in USER 
Ready; T=n.nn/n.nn hh:mm:ss HOLD status after it has been read. To remove 
this file from your reader, issue purge rdr fileno, 
where fileno is the file number of the reader file. 


7. Load (IPL) MAINT’s virtual reader: 


ip] 00c clear @ 


HCPLDR8013I Possible overlay: .SLC 000000 If you see either of these messages, you can ignore 
them. They are informational messages. 
DMSINS283E The NLSlangid saved segment could not be found; 
return code 44 from SEGMENT 


DMSINQ609R Nucleus (CYL or BLK) address = 


wi 

oa Enter the correct starting cylinder address for the 
DASD type of your 190 minidisk: 
Device Cylinder Address 
3350 068 
3375 105 
3380 066 
3390 062 

DMSINQ612R Enter version identification: Press ENTER for the default version 

ca | identification, VM/XA CMS 5.6 mm/dd/yy hh:mm. 


You will be able to modify the default in Step 14. 
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DMSINQ612R Enter installation heading: Press ENTER for the default heading, VM/XA 
= CONVERSATIONAL MONITOR SYSTEM. 
You will be able to modify the default in Step 14. 


DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 
S 

SYNONYM SYN 

CP TERM MODE VM 


Informational message: The optional installation 
segment (CMSINST) ts not loaded and saved until 
“Step 29. Create the CMSINST and HELP Saved 
Segments” on page 204 is completed. 


Ready; T=n.nn/n.nn hh:mm:ss 
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Step 12. Save and Print the CMS Load Map 


In this step, you will: 


e Save a load map of CMS on the CMS LOCALI disk 
e Print a copy of the load map. 


This step takes approximately 5 minutes. 


I. 


The CMS load map has been spooled to MAINT’s virtual printer. Ready the printer to send the CMS 
load map to MAINT’s virtual reader: 


spool prt * nohold @ 


Ready; T=n.nn/n.nn hh:mm:ss 
close prt * 


RDR FILE fileno SENT FROM MAINT The CMS load map has been sent to MAINT’s 
PRT AS fileno RECS nnnn COPY 001 A NOHOLD NOKEEP virtual reader. If you do not get this message, it 
has already been sent there by a previous IPL 190. 


If the CMS load map is sent to MAINT’s virtual printer instead of the reader, transfer it to the virtual 
reader: 


transfer prt fileno * rdr @ 

RDR FILE fileno TRANSFERRED FROM * FILE fileno 
0001 FILE TRANSFERRED 

Ready; T=n.nn/n.nn hh:mm:ss 


Identify the reader file: 


query rdr * all @ 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 
MAINT fileno M PUN nnnnnnnn 001 NONE mm/dd hh:mm:ss SYSPROG 


The CMS load map is the file with a blank 
filename and filetype. It has approximately 8,100 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUP level. Note the fileno of this file. You 
will use it in your next command. 


. Bring in the file from the virtual reader to the CMS LOCALI disk: 
access 395 d The CMS map 1s loaded on the CMS LOCAL] 
Ready; T=n.nn/n.nn hh:mm:ss disk. 


receive fileno fn ft d @ 
File fn ft D received from MAINT at * sent as (none) (none) D 
Ready; T=n.nn/n.nn hh:mm:ss 
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You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as | —9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 

5. Print a copy of the CMS load map. If you do not have a printer attached, skip this subset. 
spool @0e to system class a Mf 
Ready; T=n.nn/n.nn hh:mm:ss 


print fn ft d @ 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Examine the load map for errors: 


xedit fn ft EB 


qquit @ 


7. Continue with the next step. 
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Step 13. Install Assembler H Version 2 Program Product 


Note: IBM packages Assembler H Version 2 as a separate program product. This program product has its 
own installation procedure. 


In this step, you will: 


¢ Consult Assembler H Version 2 Program Product: Installation, SC26-4030 
e Install Assembler H Version 2 Program Product, VM feature 
e Install service for Assembler H Version 2. 


The time to perform this step may vary, but a good estimate is 20 minutes. 


1. Before you install Assembler H, consult your IBM Support Center for the latest information on APARs. 
2. Read the /nstallation manual for Assembler H Version 2 Program Product. 


3. Refer to “Installing Program Products” in the VM/XA SP2.] Program Directory for more information on 
Assembler H. 


4. Follow the directions in the /nstallation manual to install Assembler H Version 2. IBM advises you to 
install Assembler H Version 2 on the 19E minidisk. 


Note: Use the OBJECT option to assemble Assembler H CSECTS. 


5. During the installation of Assembler H Version 2, answer YES to the question “BUILD AN 
AUXILIARY DIRECTORY” and respond Y to the question asking what mode letter you want to use to 
access the disk containing the H-Assembler modules. 


6. Erase IEV6!1 TEXT. If you do not erase this file, you will not be able to apply service to Assembler H. 
7. Install the latest service level of Assembler H. 


8. After you have finished installing service for Assembler H, IPL 190: 


ip] 190 clear @ 

DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

| 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


9. Check MAINT 191 (your A-disk) for files with the same filename as files on the task disk (SES). Erase 
any duplicate files from the MAINT 191 (your A-disk) so that you will not invoke any back-level service 
EXECs. 


filelist * * fm @ This command lists all the files on the task disk 
(SES). 
PF9 Pressing PF9 on the FILELIST screen lists all the 


files with the same filename as the one where the 
cursor is positioned, with any filetype and on all 
disks. See if there is one with the same filename 
on the A-disk. 
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erase Hi Enter this command on the line listing the file you 
want to erase. Be sure to erase the file only on the 
A-disk (191), not on the task disk (SE5). 


10. If any unneeded service memos exist on the MAINT 191 disk, erase them to make room for further 
processing. 
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Step 14. Tailor the DMSNGP Profile 


In 


this step, you will use the VM System Product Editor (XEDIT) supplied with the starter system to 


tailor the CMS nucleus generation profile (DMSNGP). 


This step, excluding time for printing system definition files, takes approximately 15 minutes. 


l. 


tO 
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Before proceeding with this step, read the discussion of the DMSNGP profile in VM/XA SP Planning 
and Administration, under the discussion of the DEFNUC macro. DMSNGP ASSEMBLE is a profile 
that contains CMS configuration defaults and responses to system prompts; these will become part of the 
CMS nucleus. 


. IPL 190: 


ip! 190 clear @ 

DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mmn 

| 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


. Access the CMS LOCALI minidisk, where DMSNGP resides, as D: 


access 395 d In this example the DMSNGP file resides on the 
; 395 disk. 
Ready; T=n.nn/n.nn hh:mm:ss 


. Save a copy of DMSNGP ASSEMBLE, so that if you make a mistake in changing it, you can go back to 


the original file: 


copyfile dmsngp assemble d = oldassem = (olddate @ 
Ready; T=n.nn/n.nn hh:mm:ss 


. XEDIT the CMS nucleus generation profile: 


xedit dmsngp assemble Within the file, you can use the normal XEDIT 
cursor-control keys, scroll keys, insert key, and 
delete key. 
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NGP TITLE 'DMSNGP (CMS) 


EJECT 
DMSNGP) = CSECT 


DEFNUC SYSDISK=190, 


END 


YDISK=19E, 
HELP=19D, 
LANGID=AMENG, 
DBCS=NO0, 
LANGLEV=S, 
SAVESYS=NO, 
SYSNAME=CMS , 
USEINST=YES, 


INSTSEG=CMSINST, 


REWRITE=YES, 
IPLADDR=190, 
CYLADDR=?, 
IPLCYLO=YES, 
VERSTION=?, 


VM/XA SYSTEM PRODUCT 5664-308' 


* § disk address 

* Y¥-disk address 

* Help disk address 

* Default is American English 
* Default is not a DBCS lang 
* DCSS ID for multiple DCSS 

* Using CMS in DCSS YES OR NO 
* Name of above DCSS to save 
* Using EXEC/XEDIT in DCSS 

* Name of above DCSS to save 
* Write nucleus yes or no 

* Address of where to write 

* CYL/BLK OF WHERE TO WRITE 

* Write IPL text on cyl 0 


+ + © £© & F&F FF & © FF FE FF HF 


* VM/XA CMS 5.6 MM/DD/YY HH MM SS* 
INSTID='VM/XA CONVERSATIONAL MONITOR SYSTEM’ 


6. Look at the DEFNUC defaults, and make any necessary changes. Refer to VM/XA SP Planning and 
Administration for information on the DEFNUC macro. 


Warning: The comma at the end of each line of | the DEFNUC macro is required in all lines but the last 
line. If you omit this comma in any line other than the last line, all the lines after the first line without a 
comma are ignored. 


Warning: On each line, make sure that you leave at least one blank between the comma and the 


comment. 


e Ata minimum, you should change CYLADDR =?, to indicate the starting cylinder on the MAINT 


190 minidisk at which to start writing the CMS nucleus. The appropriate starting cylinder depends 
on the device type of the DASD where the MAINT 190 minidisk is defined: 


Device Cylinder Address 


3350 068 
3375 105 
3380 066 
3390 062 


If you do not replace the question mark for the CYLADDR keyword, you receive the following 
prompt when you generate the CMS nucleus: 


DMSINIGO09R Nucleus (CYL or BLK) address = 
You must respond with the appropriate cylinder address. 


If you specify YES after the SAVESYS option, you must create a skeleton named saved segment 
(NSS) before building the CMS nucleus. This segment is saved when you build CMS and IPL your 
reader. (You will get message HCPNSS4401.) 


A skeleton segment for the CMS nucleus is created by the SAMPNSS EXEC. You can also create 
your own skeleton segment with the DEFSYS command. For information on the DEFSYS 
command, see VM/XA SP CP Command Reference and VM/XA SP Virtual Machine Operation. 
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¢ Make sure the LANGID and HELP parameters are right for your system default national language: 


Language LANGID HELP 
Mixed-case American English AMENG 19D 
UCENG 19C 


Uppercase American English 


¢ Make any other changes you wish. For example, you may want to change the version identifier or 
the installation header. You must put single quotes around your version identifier and installation 
header. The character string between the single quotes can be any combination of alphanumeric 
characters. 


file = = fm Make your changes and file the update file on the 
CMS LOCAL] (395) disk. 


Assemble the new DMSNGFP file: 


itask assemble dmsngp @& 


: The minidisk access order is reestablished. 
DMSUPD181E No update files were found 


DMSWHM1907I Assembling DMSNGP 


Note: If an error occurs during the assembly, examine the flagged statements and correct the statements 
in error. Then continue from the beginning of this step. 


DMSWHM1909I DMSNGP TEXT A created The DMSNGP file has been assembled and placed 
PRT FILE fileno SENT FROM MAINT PUN AS fileno onthe MAINT 191 minidisk. 

RECS nnnn COPY 001 A NOHOLD NOKEEP 
Ready; T=n.nn/n.nn hh:mm:ss 


8. Copy the text deck from MAINT 191 to MAINT 395, then erase it from MAINT 191: 


If 


copy dmsngp text a = = fm (replace fm is the filemode of the CMS LOCALI minidisk. 
Ready; T=n.nn/n.nn hh:mm:ss 

erase dmsngp text a Mf 

Ready; T=n.nn/n.nn hh:mm:ss 


you did not replace the question mark for the CYLADDR keyword, when you generate the CMS 


nucleus, you will receive the following message: 


Message Appropriate Response 
DMSINI609R Nucleus (CYL or BLK) address = nnnnn 


1350 


nnnnn is the location on the 190 disk where the new 
CMS nucleus is written. Refer to the table on page 
149 to determine the correct response for your DASD 


type. 
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Step 15. ITASK EXEC Rebuilds the CMS Nucleus 


Note: Do this step only if you changed the DMSNGP file in Step 14. 


In this step, the ITASK EXEC: 


e Creates a CMS nucleus 


e Places the CMS nucleus on the CMS residence disk. 


This step takes approximately 5 minutes. 


1. Spool punch output to your own virtual reader: 


spool punch * @ 
Ready; T=n.nn/n.nn hh:mm:ss 


2. Issue ITASK BUILD CMS to create the CMS nucleus. By issuing the [TASK EXEC, you will 
incorporate updated CMS text files into a new CMS nucleus. 


itask build cms @ 
nnnnnnnn files changed 


DMSWSUL900W The existing 56643089 $SETUP Al 
file has been refreshed. You 
might want to check your access 
order when done. 


LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


RDR FILE fileno SENT FROM MAINT PUN AS fileno 
RECS nnnK COPY 001 NOHOLD NOKEEP 


Ready; T=n.nn/n.nn hh:mm:ss 


ITASK invokes the SETUP EXEC to create the 
correct CMS access order. 


You will see this message and return code 4 only if 
you did not erase 56643089 $SETUP in Step 11. 


A temporary load list is created. and the system 
loader 1s invoked. 


The CMS nucleus has been sent to your reader. 


If you get return code 4, the reason may be that a 
PTF now being applied has another PTF, outside 
CMS, as a prerequisite. Check the SVMFBLD 
SERRLOG file for message DMSBNC1854W. 


3. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build # 


4. Ensure that the proper files are in MAINT’s virtual reader: 


query rdr maint all @ 


The ALL operand requests a display of all 
information about the reader files. 
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ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT = nnnn * PUN nnnannnnn 001 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 

Ready; T=n.nn/n.nn hh:mm:ss 
This is the file you will IPL in substep 8 below. It 
has approximately 28,000 records. The exact size 
varies according to the system default language, 
local modifications, and VMSUP level. 


5. Order your reader so that the CMS nucleus will be processed first: 


order rdr fileno @ fileno is the file number of the CMS nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Ensure that the virtual reader is readied for class * reader files: 


query virtual 00c 

RDR QOOC CL ci NOCONT NOHOLD EOF READY 
000C 2540 CLOSED NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 


7. If the virtual reader is not class *, issue: 


spool rdr class * keep The KEEP option places the spool file in USER 
Ready; T=n.nn/n.nn hh:mm:ss HOLD status after it has been read. To remove 
this file from your reader, issue purge rdr fileno, 
where fileno is the file number of the reader file. 


8. Load (IPL) MAINT’s virtual reader: 


ip] 00c clear @ 
HCPLDR8015I POSSIBLE OVERLAY: .SLC Q00000 You may receive this message. It can be ignored. 


| CMS Nucleus Generation Prompts and Responses | 


Note: Each of the following prompts appears only if the corresponding statement in DMSNGP is 
missing or empty (and the DEFNUC macro contains no default value), or if the DMSNGP 
statement contains a question mark (?): 


DMSINQ606R System disk address = 


fea] 190 is the default. 
DMSINQ615R Y-disk address = 

a 19E is the default. 
DMSINQ640R HELP disk address = 

si 19D 1s the default. 


DMSINQ764R Language id = 


W@ or longid & This response identifies the /angid of your system 
national language. The default /angid is AMENG 
(mixed-case American English). 
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DMSINQ293R Is this a DBCS language? Enter 1 (YES) or © (NO). 


6 & 


DMSINQ295R Language level id = 
a 


The default is 0 (NO); mixed-case American 
English is not a DBCS (Double-Byte Character 
Set) language. 


The system national language does not use a level 
ID. 


DMSINQ296R Should the installation segment be used? Enter 1 (YES) or 0 (NO). 


M@ (or 1 M)orod & 


DMSINQ310R Installation segment name = 


M or segname @ 


DMSINI729R Do you want to save the system? Enter 
0 


DMSINI730R Saved system name = 


M@ or sysname @ 
DMSINI607R Rewrite the nucleus? Enter 1 (YES) or 
1 @ 


DMSINI608R IPL device address = 
|_| 


The installation segment is an optional shared 
saved segment, into which you can place 
frequently used EXECs and System Product 
Editor (XEDIT) macros. You install the segment 
after you install your base system, but you must 
indicate now whether or not you are going to use 
it. 

The default is 1 (YES). Enter 0 if you do not 
want to use the segment. 


This prompt appears only if you accepted the 
default (or entered 1) at the previous prompt. 


Enter a 1- to 8-alphanumeric-character name for 
the installation segment, or press ENTER to 
accept the default name, CMSINST. 


1 (YES) or 0 (NO). 
Answer 0 (NO). You will save CMS in Step 27. 
The default is 1 (YES). 


Warning: The default response to this prompt 
does not agree with the sample DMSNGP file, 
where SAVESYS=NO. 


You will not see this prompt if you answered 0 to 
the preceding prompt. 


The default system names are CMS and CMSXA. 
Q (NO). 


Enter 1 to write the CMS nucleus on the disk that 
you specify in your response to the next prompt. 


The default is the address of the system disk (190). 
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DMSINI609R Nucleus (CYL or BLK) address = 


non nnn is the location on the 190 system disk where 
the new CMS nucleus is written. Enter the correct 
cylinder/block address for your DASD type: 


Device Cylinder Address 


3350 068 
3375 105 
3380 066 
3390 062 


DMSINI610R Also IPL CYL/BLK 0? Enter 1 (YES) or 0 (NO). 


1 Enter 1 to write the initial IPL text on 
cylinder/block 0 of the disk where the CMS 
nucleus is written. 


The initial IPL text is a bootstrap program that 
reads the CMS nucleus from the cylinder/block 
where the nucleus is written (as defined in your 
response to prompt DMSINI609R). The initial 
IPL text is always written on the same 
cylinder/block as the nucleus. If the initial IPL 
text 1s not also written on cylinder/block 0, you 
must specify the cylinder/block address of the 
nucleus when you issue IPL commands for this 
system. For more information, refer to the 
description of the IPL command in VM/XA SP 
CP Command Reference. 


DMSINI611R Enter version identification: The version identification is displayed each time 
that you IPL the CMS system you are now 
generating. 

M or version @ You can enter up to 32 descriptive characters to 


identify this version and level of CMS, or you can 
press ENTER to accept the default version 
identifier, VM/XA CMS 5.6 mm/dd/yy hh:mm. 


DMSINQ612R Enter installation heading: The installation heading appears at the beginning 
of each output file created using this CMS 
nucleus. 

WM or heading @ You can enter up to 64 descriptive characters to 


serve as an installation heading, or you can press 
ENTER to accept the default heading, VM/XA 
CONVERSATIONAL MONITOR SYSTEM. 


ee End of CMS Nucleus Generation Prompts and Responses a ae 
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DMSINS327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm 
ss 


SYNONYM SYN 
CP TERM MODE VM 


Ready; T=n.nn/n.nn hh:mm:ss 


Informational message: The CMSINST 
installation segment is not loaded and saved until 
you complete Step 27 on page 192. 


This is the default version identification. If you 
defined your own version identification, it appears 
here and each time that you IPL 190 or IPL CMS. 
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Step 16. Save and Print the CMS Load Map 


In this step, you will: 


e Save a load map of CMS on the CMS LOCAL! disk 


e Print a copy of the load map. 


This step takes approximately 5 minutes. 


|. The CMS load map has been spooled to MAINT’s virtual printer. Ready the printer to send the CMS 
load map to MAINT’s virtual reader: 


spool prt * nohold Mf 
Ready; T=n.nn/n.nn hh:mm:ss 
close prt * # 


RDR FILE fileno SENT FROM MAINT The CMS load map has been sent to MAINT’s 
PRT AS fileno RECS nnnn COPY 001 A NOHOLD NOKEEP virtual reader. If you do not get this message, it 
has already been sent there by a previous IPL 190. 


2. Identify the reader file: 


query rdr * all @ 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 
MAINT fileno M PUN nannnnnn 001 NONE mm/dd hh:mm:ss SYSPROG 


The CMS load map is the file with a blank 
filename and filetype. It has approximately 8,300 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUFP level. Note the fileno of this file. You 
will use it in your next command. 


3. Bring in the file from the virtual reader to the CMS LOCAL] disk: 


access 395 d The CMS map is loaded on the CMS LOCALI1 
Ready; T=n.nn/n.nn hh:mm:ss disk. 

receive fileno fn ft d 

File fn ft D received from MAINT at * sent as (none) (none) D 

Ready; T=n.nn/n.nn hh:mm:ss 


You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month, (represented as 1 —9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 
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. To print a copy of the CMS load map, issue: 


spool @8e to system class a @ 


Ready; T=n.nn/n.nn hh:mm:ss 
print fn ft d & 
Ready; T=n.nn/n.nn hh:mm:ss 


. Examine the load map for errors: 


xedit fn ft # 
qquit 


. Continue with the next step. 
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Step 17. Tailor the Sample HCPRIO, HCPSYS, HCPBOX Files and 
the Product Parameter File 


In this step, you will: 
Edit the real I/O configuration and system definition sample files 


Tailor the HCPBOX sample file if you wish to change either the default logo that appears on your 
screen when you log on the system or the default logo that appears on separator pages 


Tailor the product parameter file only if you have a reason for changing the supplied CP nucleus 
generation information 


Assemble the real 1/O configuration file and the system definition files. 


The time to perform this step varies depending upon the time you spend editing files. 


Overview 


Note: If you are applying updates with AUX files, follow the service procedures in Part 2, “Servicing the 
System.” 


As shipped on the product tape, the product parameter file and the sample files contain sample information 
and default parameters. Based on the requirements that were established in pre-installation planning, you 
must examine and modify these files to define your unique system configuration. 


The product parameter file, 56643089 $PPF, contains information that the system generation tool (WMFBLD 
EXEC) uses when building system nuclei. 


The sample files, which you loaded from the product tape to MAINT 295 in “Step 5. Invoke the ITASK 
EXEC” on page 126, contain the following information: 


e The real I/O configuration file (HCPRIO ASSEMBLE) defines the configuration of your system 
input/output devices. 


e The CP system control file (HCPSYS ASSEMBLE) describes the system residence device (XASRES) and 
various system parameters. 


¢ The HCPBOX ASSEMBLE file defines both the logo that appears on your screen when you log on your 
system and the logo that appears on separator pages. 


Note: You may find it useful to print copies of the system files for future reference. These include HCPSYS 
ASSEMBLE, HCPRIO ASSEMBLE, and your user directory (default USER DIRECT). 

To tailor any of these files, use the VM/SP System Product Editor (XEDIT). XEDIT offers full-screen 

editing on display terminals. 


Note: When you XEDIT ASSEMBLE files, issue SET TRUNC 72 so that you do not lose the continuation 
character in column 72. 
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Procedure 
1. Access 295 as D: 


access 295 d @ 
Ready; T=n.nn/n.nn hh:mm:ss 


2. See Appendix C, “VWM/XA System Product Starter System Information” on page 725 for the sample files 
that correspond to your VM/XA System Product starter system, and “A Sample Product Parameter File” 
on page 384 for a sample product parameter file. Unless you alter them, the ITASK EXEC will use 
these files as they appear in Appendix C, “WM/XA System Product Starter System Information” when it 
creates the new CP nucleus. If you wish to alter the real I/O configuration file, the system definition 
files, or the product parameter file, follow the instructions in this step. 


HCPBOX ASSEMBLE 


If you want to change the design or contents of either the logo that appears when you log on to the system, 
or the logo that appears on separator pages, tailor the sample HCPBOX ASSEMBLE file. Do not edit 
HCPBOX ASSEMBLE. IBM services this file and bases the service on the version supplied. Use the 
procedure for local modifications. 


1. Establish the appropriate minidisk access order: 


Note: When you run VMFSETUP during the install procedures, it leaves the file 56643089 $SETUP on 
your A-disk. If VMFSETUP is run while this file exists on your A-disk, you will receive a return 
code of 4 and a DMSWSU1900W message. You may want to erase 56643089 $SETUP after 
running VMFSETUP. 


vmfsetup 56643089 cp (all 
erase 56643089 $setup a 


2. Verify that HCPXA CNTRL lists an auxiliary control file for local changes: 


xedit hcpxa cntrl 
TEXT MACS HCPGPI HCPPSI HCPOM1 HCPOM2 CPLIB DMSGPI DMSOM OSMACRO 
PAT AUXPAT TX$ * LOCAL PATCHES 


LCL AUXLCL LCL * LOCAL MODIFICATIONS 

TEXT AUXXA . 

qquit @ HCPXA CNTRL should have a line like this one. 
The second field is the filetype of the auxiliary 
control file that points to local modifications. 


3. Edit the auxiliary control file: 


xedit hcpbox auxlcl @ 


input You will add your local modifications at the top 
of the file. 
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ROOOOILC LCL LCOO001 *UPDATE HCPBOX LOGO @ In this example. RO0001LC is the filetype of the 
update file, and LC00001 is the local tracking 
number. The rest of the line, beginning with the 
asterisk (*), is a comment explaining the purpose 
of this modification. The text deck created when 
you assemble HCPBOX with your local 
modifications will be called HCPBOX LCLOO001I. 


| Press ENTER to return to the command line. 


fm is the CP LOCAL! disk (295). 


4. Create the update file and apply the updates: 


xedit hcpbox assemble (ctl hcpxa @ Instead of editing HCPBOX ASSEMBLE directly, 
you will apply changes to a copy of it. 
DMSXUP178I Applying HCPBOX AnnnnnHP The updates supplied by IBM for HCPBOX 


ASSEMBLE are being applied. 


DMSXUP180W Missing PTF file HCPBOX ROOOQO1LC F5 Your update file cannot be found because you 
have not created it yet. 


HCPBOX ROOOOILC Al The system copies the source file and allows you 
ave Hievavee: Pacers Pista ae sere Prac o ene to edit the Copy. 
ss=== * * * Top of File * * * 


===> 

set serial off Ml You want the source file’s sequence numbers and 
set trunc 72 @ continuation characters to remain unchanged. 

: Make your changes and file the update file on the 
file = = fm @ CP LOCALI (295) disk. 


HCPRIO ASSEMBLE 


You can use a procedure similar to the one shown for updating HCPBOX ASSEMBLE to update HCPRIO 
ASSEMBLE, or you can use the procedure shown below. 


1. Edit the real 1/O configuration source file. This file is on MAINT’s 295 minidisk. The file is called 
HCPRIO ASSEMBLE. 


Use the XEDIT command to edit the file. See the VM/XA SP System Product Editor User's Guide for 
information about the System Product Editor. 


You must make sure that your system volumes and consoles are defined properly in HCPRIO. If they 
are not, you will not be able to IPL your new system. 


For the real I/O configuration file, you may want to: 


¢ Delete those RDEVICE macro instructions for device numbers that the system will not be likely to 
use 


¢ Add RDEVICE macro instructions for device numbers that do not appear in the sample file. 
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Tailor HCPRIO ASSEMBLE to match the IOCDS, which is the data set that defines the I/O 
configuration for the hardware. See “System Installation on 308x, 4381, and 3090 Processor Complexes” 
on page 5. 


Note: When tailoring HCPRIO, minidisk caching is not allowed for shared DASD. To control sharing 
on a device level, use the RDEVICE SHARED = YES option in HCPRIO or use the SET 
SHARED ON FOR rdev command. These will effectively turn off minidisk caching on a device 
basis. We recommend that you set the RDEVICE macro in HCPRIO rather than using the SET 
SHARED ON FOR rdev command. 


See VM/XA SP Planning and Administration for details about HCPRIO macro instructions and for a 
high-level explanation of HCPRIO ASSEMBLE. 


2. File the edited version of the real I/O configuration file on MAINT’s 295 minidisk. Use the XEDIT 
subcommand FILE. 


HCPSYS ASSEMBLE 


You can use a procedure similar to the one shown for updating HCPBOX ASSEMBLE to update HCPSYS 
ASSEMBLE, or you can use the procedure shown below. 


1. Edit the system definition source file. The file, called HCPSYS ASSEMBLE, is on MAINT’s 295 
minidisk. 
Use the XEDIT command to edit the file. See the VM/XA SP System Product Editor User's Guide for 
information about the System Product Editor. 
For the system definition file, you may want to: 
e Change the device number for the system residence device on the SYSRES macro instruction. 


Note: By convention, IBM assigns device number 0123 for the system residence device. This device 
number appears in four places: 


~- Qn the DIRECTORY control statement in the user directory. 


— Onan MDISK control statement in MAINT’s entry in the user directory (this gives 
MAINT read/write access to the system residence device). 


— On the SYSRES macro instruction. 


| — In the product parameter file. (The device number for the system residence device might 
| not be included in the product parameter file [56643089 $PPF].) 


If you change the device number in one place, be sure to make an identical change in the 
other three places. 


¢ Modify the SYSSTORE macro instruction. Set the RMSIZE operand to the storage of your 
processor. If your system will have a virtual=real area (including storage for virtual = fixed guests), 
set the VRSIZE operand. If any virtual machines will need to issue DIAGNOSE X'98' in 
System/370 mode, or in 370-XA mode with 24-bit addressing, set the RIO370 operand. 


¢ Modify the SYSTIME macro instruction for your time zone. 


¢ Tailor the volume identifiers on the SYSCPVOL and SYSUVOL macro instructions to match the 
. volume identifiers your system will use. Because this action eliminates extraneous warning messages, 
the action helps the real system operator identify volumes that are not mounted at IPL time. 


e Supply your own system identifier on the SYSID macro instruction. 
See VM/XA SP Release Guide for Release 2.1 for details on HCPSYS macro instructions. 


2. File the edited version of the system definition file on MAINT’s 295 minidisk. Use the XEDIT 
subcommand FILE. 
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56643089 $PPF 


1. The default 56643089 S$PPF should be appropriate for most installations, but if your experience suggests 
changes, you can override 56643089 $PPF. 


DO NOT alter this file unless you have a special need. 


The best way to change the product parameter file is to create an override file. For a discussion of 
override files, see “The Product Parameter Override File” on page 402. 


Use the XEDIT command to create an override file on the TASK (SES) minidisk. See the VM/XA SP 
System Product Editor User’s Guide for information about the System Product Editor. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all the others. We recommend that you do not change 
any addresses. 


| 2. File the override file on the TASK (SE5) minidisk. Use the XEDIT subcommand FILE. 


Assemble the Files 
1. Assemble the HCPRIO, HCPSYS, and HCPBOX ASSEMBLE files: 


itask assemble filename @ If an error occurs while assembling any of the 

: system definition files, see “Correcting Assembly 
DMSWHM1907I Assembling filename Errors.” 

DMSUPD178I Updating HCPBOX ASSEMBLE Bl You will see these messages only when you 
DMSUPD1781 Applying HCPBOX AnnnnnHP F5 assemble HCPBOX ASSEMBLE, and only if you 
DMSUPD178I Applying HCPBOX ft B5 updated it. 


DMSWHM1909I filename {TEXT|ft} A created 

RDR FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 


2. Copy these text files from your A-disk to the CP LOCALI (295) minidisk: 


HCPSYS ft 

HCPRIO ft 

HCPBOX ft 
copy filename jtext|ft; a = = fm (replace M@ fm is the CP LOCAL] minidisk (the default is 
Ready; T=n.nn/n.nn hh:mm:ss 295). 


erase filename {text|ft! a 
Ready; T=n.nn/n.nn hh:mm:ss 


Correcting Assembly Errors 


To correct assembly errors in system definition ASSEMBLE files, do the following: 
1. Examine the flagged statements. See VM/XA SP Planning and Administration for directions on coding. 


2. Correct the statements causing an error by editing the system definition file with the System Product 
Editor (XEDIT). 


3. Reassemble the system definition file in which the change was made using the procedure in “Assemble the 
Files.” 


4. Repeat the sequence until all files assemble correctly. 
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Step 18. Generate the New CP Nucleus 


In this step, you will use the ITASK EXEC to build your new CP nucleus. 


This step takes approximately 20 minutes. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


1. Purge all unnecessary files from your reader to increase available spool space. 


| 2, Spool punch output to your own virtual reader: 


| spool punch * 
| Ready; T=n.nn/n.nn hh:mm:ss 


3. Invoke the ITASK EXEC to build the CP nucleus: 


itask build cp noassem Ml Use the noassem only if you have already 
assembled HCPSYS ASSEMBLE, HCPRIO 
ASSEMBLE, and HCPBOX ASSEMBLE. If you 
have not assembled these files, you must omit the 
noassem operand, so that ITASK will assemble 
them now. 


| If you assemble the files here, copy the text decks 
| from MAINT 191 to the CP LOCAL! minidisk 
| (the default is 295), then erase them on MAINT 


191. 
nonnnnnn FILES CHANGED The CP nucleus is being created. It will be sent to 
DMSACC724I 191 replaces A(191) your reader. 
LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 
RDR FILE fileno TO MAINT COPY 001 NOHOLD 
Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be that a 


PTF now being applied has another PTF, outside 
CP, as a prerequisite. Check the SVMFBLD 
SERRLOG file for message DMSBNC1854W. 


| 4. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


| vmfview build 
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164 


. Ensure that the proper files are in MAINT’s virtual reader: 


query rdr maint all @ The ALL operand requests a display of all 
information about the reader files. 

ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT nonn * PUN nnannnnnn 001 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 


Ready; T=n.nn/n.nn hh:mm:ss 
This is the file that you will IPL in substep 10 on 
page 165. It has approximately 75,000 records. 
The exact size varies according to the system 
default language, local modifications, and VMSUP 
level. 


. Order your reader so that the CP nucleus will be processed first: 


order rdr fileno @ fileno is the file number of the CP nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


Ensure that the virtual reader is readied for class * reader files: 


query virtual 00c @ 

RDR OO0C CL cl NOCONT NOHOLD' EOF READY 
QO0C 2540 CLOSED NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 


. If the virtual reader is not class *, issue: 


spool rdr class * keep @ The KEEP option places the spool file in USER 
Ready; T=n.nn/n.nn hh:mm:ss HOLD status after it has been read. To remove 
this file from your reader, issue purge rdr fileno, 
where fileno is the file number of the reader file. 


. If necessary, redefine your virtual storage. First, find out how much virtual storage MAINT has: 


query virtual storage Mf 
STORAGE = nnnnM 
Ready; T=n.nn/n.nn hh:mm:ss 


Now determine how much storage you need: 
e You need at least 16 megabytes to IPL your virtual reader in substep 10 on page 165. 


e If you are generating a CP nucleus with a preferred virtual machine, MAINT’s virtual storage must 
be at least 4 megabytes greater than the sum of the VRSIZE, VRFREE, and RIO370 operands in the 
SYSSTORE macro instruction in HCPSYS ASSEMBLE. For more information on the SYSSTORE 
macro instruction, refer to VM/XA SP Planning and Administration. 


If MAINT’s virtual storage must be set to a value greater than 32MB (the maximum size for 
MAINT as defined by the sample USER DIRECT file), then you must tailor the directory (default 
USER DIRECT) to change the maximum virtual machine size for MAINT. Once the directory is 
changed, bring it online by issuing DIRECTXA directory-name. If this is not done, you receive wait 
state 8028 when the reader is [PLed. 
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If you need to increase your storage to more than 16 megabytes, first issue: 


set machine xa Mf Storage addresses greater than 16M require 
SYSTEM RESET 370-XA architecture. If your machine ts already 
SYSTEM = XA in 370-XA mode, you will not get a response. 


If you need to increase your storage (even if you need only 16M), issue: 
define storage nnnnm Hf 


STORAGE = nnnnM 
STORAGE CLEARED - SYSTEM RESET 


10. Load (IPL) MAINT’s virtual reader: 


ip] 00c clear @ 


hh:mm:ss * MSG FROM MAINT — : The 9010 disabled wait state indicates that the CP 
HCPGEN9010W NUCLEUS LOADED ON XASRES nucleus was successfully loaded on the system 
HCPGIR450W CP ENTERED; DISABLED WAIT residence device. 


PSH Q00A0000 00009010 If you receive disabled wait state code 8028, see 


“Correcting IPL Errors” below. 


If you receive a different disabled wait state code, 
see VM/XA SP System Messages and Codes 
Reference. 


11. Issue the following commands to ensure that these settings are in effect: 


set machine 370 If your machine is already in 370 mode, or if your 
SYSTEM RESET storage is already 16M, you will not get a 
SYSTEM = 370 response. 


define storage 16m Mf 
STORAGE = 0016M 
STORAGE CLEARED - SYSTEM RESET 


You have now loaded the CP nucleus. 


Correcting IPL Errors 
If you receive disabled wait state code 8028 when you try to IPL your reader, you must correct the problem 
as follows: 

1. Close the reader. Issue CLOSE RDR. 

2. Determine the reader file number of the IPL deck. Issue QUERY RDR ALL. 


3. Take the IPL deck out of USER HOLD status. Issue CHANGE RDR mnnn NOHOLD, where nnnn is 
the reader file number of the IPL deck. If this step is not done, you will receive wait state 232 when the 
reader is re-I[PLed. 


4. Tailor the directory (default USER DIRECT) as described in substep 9 on page 164. 
5. Reissue DIRECTXA directory-name. 
6. IPL the reader. Issue IPL C CLEAR. 
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Correcting Load Errors 


If the new CP nucleus fails to load, do the following: 


l. 


IPL CMS: 


ip] 190 clear @ 
PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 
DMSWSP327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm If you have changed the version heading, your 
es own heading will appear. 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


. Access 295, then inspect the CP load map and virtual PSW. An error in loading may show up in either 


the load map or in the PSW. 


For a list of loader wait-state codes, refer to VM/XA SP System Messages and Codes Reference. 


. Correct the error. 


. Go back to the point where the error may have occurred. If you cannot determine where the error may 


have occurred, see “Step 13. Install Assembler H Version 2 Program Product” on page 146. 
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Step 19. Save and Print the CP Load Map 


In this step, you will: 


e IPL CMS 
e Save the load map of the new CP system 
e Print a copy of the new CP load map. 


This step takes approximately 10 minutes. 


1. When you built CP, the CP load map was spooled to MAINT’s virtual printer. The load map must be 
transferred to MAINT’s virtual reader. If you have IPLed 190 since building CP, the load map may 
have already been spooled from the virtual printer to the virtual reader. 


Query the printer to see if the load map is still there. If itis, note the file number. If it is not, skip 
substep 3 and go to substep 2. 


query prt all @ 

OWNERID FILE CLASS RECORDS CPY HOLD DATE TIME DIST 

MAINT fileno A PRT nnonnnnnn 001 NONE mn/dd hh:mm:ss SYSPROG 

Ready; T=n.nn/n.nn hh:mm:ss The CP load map is the file with a blank filename 
and filetype. It has approximately 30,000 records. 
The exact size varies according to the system 
default language, local modifications, and VMSUP 
level. 


2. IPL CMS: 


ip] 196 clear @ 

DMSWSP327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

& 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


| CP Load Map in Virtual Printer Only | 


3. Transfer the printer file to your reader: 
transfer prt fileno * rdr Hf 
RDR FILE fileno TRANSFERRED FROM * FILE fileno 


Q001 FILE TRANSFERRED 
Ready; T=n.nn/n.nn hh:mm:ss 


[odd of CP Load Map in Virtual Printer Only SCS 
4. Access the CP LOCALI disk: 


access 295 d This is the disk on which you will receive the load 
Ready; T=n.nn/n.nn hh:mm:ss map. 
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5. Identify the reader file: 


query rdr * all @ 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST USERFORM OPERFORM KEEP MSG 
MAINT fileno A PUN nnnnnnnn 001 NONE mm/dd hh:mm:ss SYSPROG STANDARD STANDARD OFF OFF 


The CP load map is the file with a blank filename 
and filetype. It has approximately 30,000 records. 
The exact size varies according to the system 
default language, local modifications, and VMSUP 
level. 


Note the fi/eno of this file. You will use it in your 
next command. 


6. Bring in the file from the reader to the CP LOCALI disk: 


receive fileno fn ft d @ This command saves the load map on the CP 
fn ft D1 created LOCAL] (295) minidisk. 
DMSRDC738I Record length is 132 bytes 
File fn ft D received from MAINT at * 
sent as (none) (none) D 


You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as 1 —9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 


7. To print a copy of the load map for the CP nucleus, issue: 


spool 00c class a @ 
Ready; T=n.nn/n.nn hh:mm:ss 


print fn ft d The load map is printed on your system printer. 
Ready; T=n.nn/n.nn hh:mm:ss 


8. Examine the load map for errors: 


xedit fn ft 


9. Examine the load map for unresolved symbols. There should be no unresolved symbols. 


locate /unresol You are still in XEDIT mode. 


DMSXDC546E Target not found 
qquit # 
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Step 20. Load the New CP Nucleus 


In this step, you will: 
e Shut down the VM/XA System Product starter system 


e Perform an initial program load of the new CP nucleus. 


This step takes approximately 10 minutes. 


1. Shut down the starter system you are now using. A class A user (usually the primary system operator) 
must issue the SHUTDOWN command. 


shutdown 

SYSTEM SHUTDOWN STARTED 

Ready; T=n.nn/n.nn hh:mm:ss 

SYSTEM WARM START DATA SAVED 

SYSTEM SHUTDOWN COMPLETE 

HCPGIR450W CP ENTERED; DISABLED WAIT 
PSW ODOOADQ00 00000961 


~ 


IPL the virtual address of your system residence device. 


If you are unable to IPL your system residence device, go back to “Step 2. Restore the VM/XA System 
Product Starter System to Disk” on page 115 and continue from there. 


ipl] vdevno clear @ 

VM/XA SYSTEM PRODUCT RELEASE 21 SERVICE LEVEL 0000; 
SYSTEM NUCLEUS CREATED ON mm/dd/yy AT hh:mm:ss, 
LOADED FROM XASRES 


KEKEKKKEKKKEKK KERR KEKE KEKKEREKER 


* LICENSED MATERIALS - PROPERTY OF IBM* * 
* * 
* 5664-308 (C) COPYRIGHT IBM CORP. 1983, * 
* 1989. ALL RIGHTS RESERVED. : 
* US GOVERNMENT USERS RESTRICTED RIGHTS - * 
* USE, DUPLICATION OR DISCLOSURE * 
* RESTRICTED BY GSA ADP SCHEDULE CONTRACT * 
WITH IBM CORP. * 

* 

* 

* 


* TRADEMARK OF INTERNATIONAL BUSINESS 
MACHINES. 


KRKKKKEKEEKRKRKERREREKKAKKERKKKKKKKKKKKKKKKKK KKK 


* 
* 
* 
* 


HCPISU9511 CP VOLID volid NOT MOUNTED 


Note: A 9025 disabled wait state indicates that your system volume (XASRES) is not defined in the 
HCPRIO ASSEMBLE file. A 1010 disabled wait state indicates that your console is not defined 
in the HCPRIO ASSEMBLE file. 
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3. During the initialization phase, respond cold drain to the START message: 


START ((COLD|WARM|FORCE) (DRAIN) (DISABLE) (NODIRECT)) | (SHUTDOWN) 
cold drain @ 


NOW hh:mm:ss EDT weekday mm/dd/yy You cannot set the clock at second level. Answer 
CHANGE TOD CLOCK (YES|NO): no. 
no @ 


The directory on volume XASRES at address nnnn 
has been brought online. 

There is no logmsg data 

FILES: NO RDR, NO PRT, NO PUN 

LOGON AT hh:mm:ss EST day mm/dd/yy 


HCPCPJ951I CP volid volid not mounted volid is a DASD volume listed on the SYSCPVOL 
: macro instruction of HCPSYS. If the volume is 
not one that you are using, ignore the message. 


You are now logged on to the OPERATOR user ID. 


STORAGE = 0016M 
FILES 0000001 RDR, 0000001 PRT, NO PUN 


XAUTOLOG AUTOLOG1 After you have modified the user directory, these 
HCPAUTO53E AUTOLOG1 not in CP directory error messages will no longer appear. 

XAUTOLOG EREP 

HCPAUTO53E EREP not in CP directory 

XAUTOLOG DISKACNT 

HCPAUTO53E DISKACNT not in CP directory 


4. Define the storage that you want for the OPERATOR user ID: 


define storage 16m MF This is an example. You may define more than 
STORAGE = 0016M 16M. 
STORAGE CLEARED - SYSTEM RESET 


5. Enable the devices in your revised HCPRIO file: 


enable all 
hh:mm:ss Command complete 
terminal mode vm @ 


6. IPL 190: 


ip] 190 ciear Hf 
DMSWSP327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 


|_| 
DMSACP1123E A(191) device error If you see this error message, you have not 
Ready; T=n.nn/n.nn hh:mm:ss formatted the operator’s 191 minidisk. 


170 Installation and Service 


7. Format the operator’s 191 minidisk only if you have not already done so: 


format 191 a @ 

DMSFOR603R FORMAT will erase all files on disk A(191). 
Do you wish to continue? 
Enter 1 (YES) or 0 (NO). 

1 @ 

DMSFOR605R Enter disk label: 

oprl191 @ 

DMSFOR733I Formatting disk A 

DMSFOR732I n cylinders formatted on A(191) 

Ready; T=n.nn/n.nn hh:mm:ss 


8. Disconnect from OPERATOR and log on as MAINT. 
Note: If you do not have XAPOO1, you will receive this message: 
HCPLNDIO8E MAINT 0124 NOT LINKED 
when you log on as MAINT. If you are using 3380 or 3390 DASD, you can ignore this message. 


Chapter 3. Installing VM/XA System Product Release 2.1 with the Starter System (Second Level) 171 


Step 21. Update the User Directory 


In this step, you will: 


e Edit the sample user directory 
¢ Use the DIRECTXA command to update the user directory. 


The time to perform this step varies depending on the time you take to edit files. 


|. See Appendix C, “VM/XA System Product Starter System Information” on page 725 for sample user 
directories. 


Note: All logon passwords are NOLOG and there are no MDISK passwords, except for some of 
MAINT’s minidisks. You may want to change these. 


2. Edit the sample user directory (USER DIRECT on MAINT’s 295 minidisk): 


access 295 d @ 
xedit user direct 


Be sure to change the logon passwords in USER DIRECT from NOLOG to your own non-restricted 
installation passwords. (For a list of restricted passwords, see Appendix F, “Restricted Logon 
Passwords” on page 859.) Also, be sure to change the logon password you provided for the MAINT 
and OPERATOR virtual machines in “Step 5. Invoke the ITASK EXEC” on page 126. This password 
appeared in the console file. 


Also, take this opportunity to add or change MDISK passwords for the MDISKs defined in USER 
DIRECT. Note that the read, write, and multiple-write passwords are positional. Refer to the skeletal 
MDISK statement provided in USER DIRECT. If you will be starting accounting and error recording 
later, this is a good time to add or change MDISK passwords for the DISKACNT and EREP 191 
minidisks. 


For more information about the user directory, see VM/XA SP Planning and Administration. 
3. When your changes are complete, enter file on the command line. 
4. Use the DIRECTXA command to update and place the user directory online: 

directxa user direct @ 

VM/XA SYSTEM PRODUCT USER DIRECTORY CREATION PROGRAM - RELEASE 2.1 


E0J DIRECTORY UPDATED AND ON LINE 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 22. ITASK Loads HELP Files from the Product Tape (Volume 2) 


In this step, the ITASK EXEC loads HELP files from Volume 2 of the product tape. 


The time this step takes varies from system to system, but a good estimate is 40 minutes. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


ip 


Attach your tape device as 181 and mount Volume 2 of the product tape on it. 


Follow the operation manual for the machine on which you mount the tape. 


. Enter the ITASK command with the LOAD AMENGHLP, LOAD UCENGHLP, or LOAD HELP 


operands to load the HELP files. Should a problem occur during this step, or for some reason you want 
to return to this step and load these tape files, you can invoke the load function by entering the ITASK 


command again. 


itask load {amenghIp|ucenghIp|help} The HELP files on the tape are in mixed-case 
American English: 


e Use the amenghlp operand to load the HELP 
files to the 19D disk. 


e Use the ucenghlp operand to load the HELP 
files directly to the 19C disk, then convert 
them to uppercase. Conversion takes about 
20 minutes. 


¢ Use the help operand to load the HELP files 
to the 19D disk, then copy them to the 19C 
disk and convert the copied files to uppercase. 


DMSWSL409I Loading AMENGHLP FILES to the You will see this message if you used the amenghip 
19D disk attached to MAINT or help operand. 

DMSWSL409I Loading UCENGHLP FILES to the You will see this message if you used the ucenghlp 
19C disk attached to MAINT operand. 

CONVERTING HELP FILES TO UPPERCASE You will see this message if you used the ucenghlp 

Ready; T=n.nn/n.nn hh:mm:ss or help operand. 
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Step 23. ITASK Loads Source Files from the Product Tape (Volume 
3) 


In this step, the ITASK EXEC loads CP, CMS, and dump viewing facility source files from Volume 3 of 
the product tape. 


The time this step takes varies from system to system, but a good estimate is 30 minutes. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


1. Attach your tape device as 181 and mount Volume 3 of the product tape on it. 
Follow the operation manual for the machine on which you mount the tape. 


Enter the ITASK command with the LOAD ALL3 operands to load all the source files. Should a 
problem occur during this step, or for some reason you want to return to this step and load these tape 
files, you can invoke the load function by entering the ITASK LOAD ALL3 command again. 


No 


itask load all3 B 


DMSWSL409I Loading CP SOURCE to the These are messages from ITASK as it loads files 
394 disk attached to MAINT from the product tape. 

DMSWSL409I Loading CMS SOURCE to the 
393 disk attached to MAINT 

DMSWSL4Q9I Loading DUMPVIEW SOURCE to the 
393 disk attached to MAINT 


Ready; T=n.nn/n.nn hh:mm:ss ITASK has finished restoring source files from 


Volume 3 of the product tape. 


| Note: Source files are not unpacked during the load. 
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Step 24. Install Environmental Record Editing and Printing 


In this step, you will: 


e Read the documentation for the Environmental Record Editing and Printing (EREP) Program 
e Follow the directions to install EREP. 


The time to perform this step may vary, but a good estimate is 15 minutes. 


Note: IBM packages the Environmental Record Editing and Printing (EREP) Program, VM Feature, 
5654-260, as a separate program product. This program product has its own installation procedure. 


1. Read the documentation for EREP: 
¢ The following memos in tape files 1 and 2 of the VMSUP EREP tape: 


— 5654260B MEMO 

— F5654260 MEMO2 
— [5654260 MEMO 

— 5654260B SERVICE 


e The Program Directory for EREP, which describes the installation procedure for EREP. 
Note: This document does not come with the VMSUP tape. You must order it separately. 
¢ The discussion of EREP in VM/XA SP Planning and Administration. 
2. Follow the directions in the EREP Program Directory to install EREP from the VMSUP EREP tape. 
Note: You will receive messages HCPCRC80591 and HCPCRC8060I until EREP is installed. 


3. IPL 190: 


ip] 190 clear @ 
DMSINS3271I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm 
a Press ENTER to complete CMS initialization. 


SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 25. Install the Printer Image Library 


In this step, you will install an image library for your printer and save it on tape. 


This step takes approximately 10 minutes. 


Warning: Do not attach the tape unit to MAINT. SPTAPE will attach it. If you have any other tape 
unit attached, detach it. 


1. Load (IPL) 190. This is the CMS system disk. 


ip] 196 clear @ 
DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 


a Press ENTER to complete CMS initialization. 
SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


2. Establish the correct minidisk access order: 


Note: When you run VMFSETUP during the install procedures, it leaves the file 56643089 $SETUP on 
your A-disk. If VMFSETUP is run while this file exists on your A-disk, you receive a return code 
of 4 and a DMSWSU1900W message. You may want to erase 56643089 $SETUP after running 
VMFSETUP. 


access 565 b 

vmfsetup 56643089 cp & 
Ready; T=n.nn/n.nn hh:mm:ss 
erase 56643089 $setup a Ml 
Ready; T=n.nn/n.nn hh:mm:ss 


3. Invoke the IMAGELIB command. The command requires the filename of the image library (fn 
CNTRL). IBM supplies default image library control files called IMAGxxxx CNTRL, where xxxx is 
the printer number: 3800, 1403, 3203, 3211, 3262, 4245, or 4248. 


For more information about image libraries, see VM/XA SP Planning and Administration. 


imagelib libname @ If you use the IBM-supplied image library, 
HCPNMT247I1 NAMED IMAGE IMAGxxxx CREATED libname is IMAGxxxx, where xxxx is the printer 
Ready; T=n.nn/n.nn hh:mm:ss number. 


4. Check the status of the image library: 


query img all 
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OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*IMG nonn IMG A= nnnn mm/dd hh:mm:ss fn IMG MAINT 


Check the current state of the file (CL), the 
filename, and filetype. 


5. Issue the appropriate LOADBUF command and start the printer. See VM/XA SP CP Command 
Reference for more information. 


6. Mount a scratch tape with ring on an available 3420, 3422, or 3430 tape drive, or insert a cartridge into 
an available 3480 unit, with the thumbwheel turned until the white dot is not visible. Follow machine 
operations manuals to mount the tape. 


¢ Do not attach the tape unit to MAINT. SPTAPE will attach it. If you have any other tape unit 
attached, detach it. 
e The tape is suitable for a 3420, 3422, 3430, or 3480 tape unit. 


Note: This procedure assumes the tape mode is 1600 bits per inch. 


7. Issue the SPTAPE command to dump the image library to tape: 


sptape dump vdevno img all run @ Substitute the virtual device number of the tape 
drive for the value vdevno. The operand RUN 
specifies that SPTAPE rewinds and unloads the 
tape after the operation. 


DUMPING vdevno IMG *IMG nonn A The message from SPTAPE tells you the file is 

being dumped to tape. 

SPTAPE DUMP FUNCTION ON 
DRIVE vdevno COMPLETE 

Ready; T=n.nn/n.nn hh:mm:ss 


8. Store the tape for emergency use. If it is ever necessary, you can use this tape and the SPTAPE LOAD 
181 IMG ALL RUN command to restore the image libraries. For more information about the SPTAPE 
command, see VM/XA SP Real System Operation. 


9. If necessary, reattach your tape drive. 
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Step 26. Load, Build, and Save GCS 


You must install the GCS (group control system) component if you plan to install SNA products or RSCS 
Version 2. Before you begin, read “Planning for the Group Control System (GCS)” on page 9. 


If you do not want to install GCS, go to “Step 28. Install the CMSDOS, CMSBAM, CMSVSAM, and 
CMSAMS Saved Segments” on page 196. 


To install GCS, you will do the following steps: 
¢ Load GCS from Volume 2 of the product tape. 
¢ Invoke the GROUP EXEC and complete a series of panels to create a GCS configuration file. 


Note: If you do not have a full-screen display device, you cannot use the GROUP EXEC because 
you cannot display the panels. In that case, you must build the configuration file manually, 
using the build macros described in the VM/XA SP Group Control System Command and 
Macro Reference. 


After you complete the panels, you invoke the ITASK EXEC with the BUILD GCS parameters. 
ITASK: 


~ Modifies a copy of the GCS loadlist (GCSLOAD EXEC) and changes the entry that contains the 
filename of the GCS configuration file (the default is GCS) to match the filename of the 
configuration file that you just created (the default is also GCS). 
Files the modified loadlist on the MAINT 295 minidisk. The modified loadlist is used during the 


generation of the GCS named saved system. 

Renames the filetype of the GCS configuration file from GROUP to ASSEMBLE. 

Invokes VMFHASM EXEC to assemble the configuration file. 

Invokes VMFBLD EXEC with the BUILD GCS parameters to build and save the GCS nucleus. 


After you build and save the nucleus, you can save and print the GCS load map, which contains the 
storage addresses of the nucleus control sections and entry points. 


If you want to install more than one GCS nucleus, you must re-access the GCS minidisk structure 
and re-invoke the GROUP EXEC to create another GCS configuration file. Each configuration file 
must have a unique name and have an entry in the SAMPNSS EXEC. 


This step takes approximately 30 minutes for each GCS system. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all the others. We recommend that you do not change any 
addresses. 


1. Attach a tape drive to MAINT. 
2. Mount Volume 2 of the product tape. 
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3. Issue ITASK LOAD GCS to load the GCS code: 


itask load gcs Hf 
DMSWSL409I LOADING GCS INTERFACE TO 
THE 190 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS OBJECT TO 
THE 595 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS PUTAPPLY TO 
THE 592 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS PUTDELTA TO 
THE 596 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS CORAPPLY TO 
| THE 592 DISK ATTACHED TO MAINT 
| DMSWSL409I LOADING GCS CORDELTA TO 
| THE 596 DISK ATTACHED TO MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


4. IPL 190: 


ip] 1969 clear @ 
DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 


x Press ENTER to complete CMS initialization. 
SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


5. Establish the correct minidisk order: 


| access 5£5 b 
vmfsetup 56643089 gcs (all @ 
Ready; T=n.nn/n.nn hh:mm:ss 
erase 56643089 $setup a Mf 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Set up the GROUP EXEC messages in storage: 
Notes: 


a. If you are REBUILDING a GCS nucleus and your current configuration file does not require 
changes, you can skip this part of the step and go directly to the nucleus build operation on page 
187. 


b. If you do not have a full-screen display device, you cannot use the GROUP EXEC to build the 
configuration file. Do Not set up the GCS messages in storage. Instead, refer to the VM/XA SP 
Group Control System Command and Macro Reference and use the build macros described there to 
build the configuration file manually. Then continue this step with the nucleus build operation on 
page 187. 


copyfile csimes[y] [text|txtnnnnn] fm csiume[y|text a 

Ready; T=n.nn/n.nn hh:mm:ss y is the country code for your system default 
national language: blank for mixed-case American 
English and b for uppercase American English. 
You can use QUERY LANGLIST to determine 
your system default national language. 
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180 


The CSIMES text file is shipped as TXTnnnnn. The most current version of this file can be determined 
by referring to the first entry in the CSIMES AUX file. In the first entry, there is a UMnnnnn field, 
where nnnnn is the PTF number. 


Note: If you have not received service on the CSIMES text file, you do not have a CSIMES file with a 
filetype of TXTnnnnn. You will have one with a filetype of TEXT. 


This command creates a temporary GCS message file (containing the messages for the GROUP EXEC) 
that has the filename required by the SET LANGUAGE command. A permanent message file will be 
created when you generate the GCS nucleus. If there has been any service to the message file, the 
permanent file will reflect it. 


set language langid (add csi user @ langid identifies your system default national 

Ready; T=n.nn/n.nn hh:mm:ss language. At this point, /angid will be either 
ameng (mixed-case American English) or uceng 
(uppercase American English). 


This command sets the language of the temporary 
GCS message file and places the file in user 
storage. 


. Invoke the GROUP EXEC to display the configuration panels. 


Use your installation reference worksheet to help you complete the panels. For more information, see 
“Planning for the Group Control System (GCS)” on page 9. 


group systemname @ This command assigns systemname as the filename 
of the GCS configuration file that you are creating 
and invokes the Primary Option Menu. The 
systemname parameter is optional at this time. If 
specified, it must match the system name in the 
DEFSYS entry for this GCS system in the 
SAMPNSS EXEC (the sample system name Is 
GCS). If you specify a system name here, the 
Primary Option Menu appears with the system 
name filled in. If you do not specify a system 
name here, you must specify one on the Primary 
Option Menu. 
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Table 3. Function Keys Used with the GROUP EXEC Panels 


a 
PF1 HELP Shows information about the panel you are looking at. 


Key 
PF2 CLEAR Clears the input areas where you enter information. 
577E File has been changed; type QQUIT to quit 


e If you press PF3 on the Primary Option Menu, you return to CMS. 

e If you press PF3 on any other screen, you return to the Primary Option 
Menu. 

¢ If you press PF3 after you have entered information, but have not saved 
it, you receive the message: 


Leaves the present panel and returns you to a previous one. 
anyway 7 


PFS REFRESH Fills in the panel’s input areas with the values you last saved there. 


Moves the cursor to the panel’s command line. 


ENTER 


PF6 SAVE Saves information you’ve entered on the panel (for the configuration file 
systemname GROUP). 


Processes any valid CP or CMS command typed on the command line. Two 
specific commands you can enter are: 


1. QQUIT, entered from the Primary Option Menu, returns you to CMS. 
If entered on any other panel, it returns you to the Primary Option 
Menu. 

2. CANCEL, entered on any panel, returns you to CMS. 
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GCS GROUP - PRIMARY OPTION MENU Primary 


Fill in the blanks with the required information and then press the ENTER key. 
Type/change the name of the saved system that is being defined. 
SYSTEM NAME : 
Type one number from the list below to display/update the: 
1. Authorized VM Userids. 


2. Saved System Information. 
3. Saved Segment Links. 


Type your choice here: _ 


PF: 1 HELP 2 CLEAR 3 END oe eee 6 ... 
PFs 7 ane S see 9 VERIFY 10 ... or 12 CURSOR 


cose > 


8. To complete the Primary Option Menu: 
a. Fill in or change the SYSTEM NAME. 


If you invoked GROUP with the systemname parameter, this panel appears with the SYSTEM 
NAME already filled in. 


b. Select the next panel (1, 2, or 3) and press ENTER. 


The first time you leave the Primary Option Menu, select panel 1; the next time, panel 2; the third 
time, panel 3. 


182 Installation and Service 


AUTHORIZED VM USERIDS FOR < PAGE 1 OF 1 


To ADD, fill in the blanks with the authorized VM userids. 
To CHANGE, type a new userid over the userid to be changed. 
To DELETE, type blanks on the line. 


Pressing the ENTER key or PF6 key will save the update. 


PFs 1 HELP 2 CLEAR 3 END eee 5 REFRESH 6 SAVE 
PF: 7 PREVIOUS 8 NEXT 9 VERIFY 10 . ll... 12 CURSOR 


= 


9. To complete the Authorized Userids panel: 
a. Type in the user IDs. 


Press ENTER or PF6 after typing the user [Ds to save your information. Every time you press 
ENTER or PF6, the GROUP EXEC tells you how many user IDs it has processed. Use PF7 and 
PF8 if you have more than one screenful of user IDs. 


b. Return to the Primary Option Menu. 


Press PF3. If you forget to press ENTER or PF6, you will remain on this screen and see the 
message: 


577E File has been changed; type QQUIT to quit anyway 


To continue, simply press PF6. You will receive a message telling you how many authorized user 
IDs the EXEC has processed. Press PF3 again to return to the Primary Option Menu. 
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GRP121 PAGE 1 OF 2 


To ADD, fill in the blanks with the information. 
To CHANGE, type the information over the displayed value. 
To DELETE, type blanks on the line. 


Pressing the ENTER key or PF6 key will save the update. 


SYSTEM DISK address (S-disk) .....3 595 
SYSTEM DISK EXTENSION address (Y-disk): 59E 


USERID to RECEIVE STORAGE DUMPS. .. .: 
RECOVERY MACHINE USERID (required) . .: 


GCS TRACE TABLE SIZE (minimum 4K). . .: 


PF: 1 HELP 2 CLEAR 3 END , 5 REFRESH 6 SAVE 
PFs 7 oe 8 NEXT Q VERIFY 10 .. ll... 12 CURSOR 


cocS> 


10. To complete the first Saved System Information panel: 
a. Specify your disk addresses. 


The default 595 and 59E virtual addresses are already saved and verified. If you must choose 
different addresses, type over the default values. 


Note: Make sure the new information is correct; the GROUP EXEC does not prevent you from 
saving invalid information. 


b. Name an authorized dump receiver. 
Name an authorized recovery machine. 


GCS requires you to enter a recovery machine user ID. The GROUP EXEC tells you whether that 
user ID is valid, but it does not prevent you from saving an invalid entry. 


c. Specify a trace table size. 


By default, the GROUP EXEC saves a value of 16K. If you decide to save a different amount, 
simply type the new value over the default value. 


d. Save your input. 


If you are satisfied with your choices, press PF6 or ENTER to save the information. 


Warning: If you do not save the information before going on, the system will not accept it as input. 
e. Go to the second panel. 


Press PF8 to continue on the second Saved System Information panel. 
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GRP122 SAVED SYSTEM INFORMATION FOR < PAGE 2 OF 2 


To ADD, fill in the blanks with the information. 
To CHANGE, type the information over the displayed value. 
To DELETE, type blanks on the line. 


Pressing the ENTER key or PF6 key will save the update. 


MAXIMUM NUMBER of VIRTUAL MACHINES (required). .: 


SYSTEM ID (maximum 130 characters) 


PF: 1 HELP 2 CLEAR 3 END ° 5 REFRESH 6 SAVE 
PF: 7 PREVIOUS 8 ... D -si0e ee LD owes 12 CURSOR 


s2eSs> 


11. To complete the second Saved System Information panel: 
a. Specify a MAXIMUM NUMBER. 


Simply type a value of 1 or more, and press ENTER. The GROUP EXEC responds with a message 
only if you enter an invalid value. 


b. Type in your SYSTEM ID text. 


This is optional. Move the cursor to the SYSTEM ID space (if it is not already there) and enter 
your text. The GROUP EXEC does not let you enter any more than 130 characters. 


c. Save your input and return to the Primary Option Menu. 


Press ENTER to save your information and then press PE3. 
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GRP13 AUTOMATIC SAVED SEGMENT LINKS FOR < PAGE 1 OF 1 


To ADD, fill in the blanks with the saved segment names 
that will be linked automatically during 
initialization of this virtual machine group. 

To CHANGE, type a new saved segment name over the saved 
segment name to be changed. 

To DELETE, type blanks on the line. 


Pressing the ENTER key or PF6 key will save the update. 


PF: 1 HELP 2 CLEAR 3 END ae 5 REFRESH 6 SAVE 
PF: 7 PREVIOUS 8 NEXT 9 VERIFY 10 ... ae 12 CURSOR 


===> 


12. To complete the Automatic Saved Segment Links panel: 
Note: Do not include CMSVSAM and CMSBAM segments here. 
a. Type in the segment names. 


Press ENTER or PF6 after typing each segment name to save your information and advance to the 
next space at the same time. Every time you press ENTER or PF6, the EXEC tells you how many 
segment names it has processed. Use PF7 and PF8 if you have more than one screen of names. 


b. Return to the Primary Option Menu. 


If you have not saved your input yet, press ENTER or PF6. Press PF3 to return to the Primary 
Option Menu. 


13. Once you have provided the necessary input on all panels and returned to the Primary Option Menu for 
the last time, press PF3 to exit from the GROUP EXEC. 


14. Remove the temporary GCS message file from user storage and erase it from your A-disk: 


set language langid (delete csi user @ langid is your system default national language. If 
erase csiume[y] text a Mf you have not installed a different one, your default 
is ameng. 


15. Spool punch output to your own virtual reader: 


spool punch * @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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16. Invoke the ITASK EXEC with the BUILD GCS parameters: 


itask build gcs systemname @ systemname must match the name you specified 
when you issued the GROUP EXEC. If you do 
not specify a name, the default is GCS. 


HCPNSD440I The Named Saved System (NSS) systemname 
was successfully defined 
in fileid fileno 
OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) S_onann mm/dd hh:mm:ss GCS NSS MAINT 


DMSUPD181E No update files were found 
DMSWHM19071 Assembling systemname 
DMSWHM19091 systemname TEXT A created 
191 replaces A (191) 

5E5 replaces B (5E5) 


| If You Receive an Assembly Error | 


If you receive an assembly error, you may have to reestablish the minidisk access order: 


access 5E5 b Hf 
vmfsetup 56643089 gcs (all @ 
erase 56643089 $setup a 


Then go back and check your configuration file, which ITASK has renamed systemname ASSEMBLE. 
Refer to “Planning for the Group Control System (GCS)” on page 9 for information regarding required 
fields. Correct the file or go through the GROUP EXEC panels again to recreate the file. (If you 
recreate the configuration file, you must use the same systemname.) After you recreate the configuration 
file, rename or erase the old systemname ASSEMBLE file, then rename the new configuration file from 
GROUP to ASSEMBLE. Issue the ITASK BUILD GCS systemname command to assemble the 
configuration file and to build and save the nucleus. 


We ceaceoe oe tetas End of If You Receive an Assembly Error ee eee eens, 


PRT FILE fileno SENT FROM MAINT PRT AS fileno These are informational messages. You can 
RECS nnnn COPY 001 A NOHOLD NOKEEP ignore them. 
nnnnnnn FILES CHANGED 


LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


RDR FILE fileno SENT FROM MAINT PUN AS fileno The GCS nucleus has been sent to MAINT’s 
RECS nnnn COPY 001 A NOHOLD NOKEEP virtual reader. 


Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be that a 
PTF which is now being applied has another PTF, 
outside GCS, as a prerequisite. Check the 
$SVMFBLD $ERRLOG file for message 
DMSBNC1854W. 


17. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build @ 
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18. 


19. 


20. 


21; 


Copy the text deck, configuration file, ASSEMBLE file, and EXEC from MAINT 191 to MAINT 495: 


access 495 d @ 

Ready; T=n.nn/n.nn hh:mm:ss 

copy systemname text a = = d (replace @ 
Ready; T=n.nn/n.nn hh:mm:ss 

erase systemname text a Hf 

Ready; T=n.nn/n.nn hh:mm:ss 

copy systemname group a = = d (replace M@ 
Ready; T=n.nn/n.nn hh:mm:ss 

erase systemname group a Mf 

Ready; T=n.nn/n.nn hh:mm:ss 

copy systemname assemble a = = d (replace @ 
Ready; T=n.nn/n.nn hh:mm:ss 

erase systemname assemble a 

Ready; T=n.nn/n.nn hh:mm:ss 


Verify that the GCS nucleus is in MAINT’s virtual reader: 


query rdr maint all @ The ALL operand requests a display of all 
information about the reader files. 

ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT nnnn * PUN nnnnnnnn 001 NONE mm/dd hh:mm:ss fn ft SYSPROG 


Ready; T=n.nn/n.nn hh:mm:ss 
This is the file that you will IPL in substep 22 on 
page 189. It has approximately 8,000 records. 
The exact size varies according to the system 
default language, local modifications, and VMSUP 
level. 


The name of the IPL deck is the same as the last 
entry in the GCS load list. If you have difficulty 
identifying the IPL deck and need to know the 
reader file number, refer to the last entry in the 
GSC load list systemname EXEC. (The default 
name is GCSLOAD EXEC). 


Order your reader so that the GCS nucleus will be processed first: 


order rdr fileno fileno is the file number of the GCS nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


Query the reader. If it is not class *, spool it as class *: 
p 


query virtual c @ 

RDR OOOC CL cl NOCONT NOHOLD EOF READY 
Q00C nnnnnCLOSED NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 

spool c class * @ 

Ready; T=n.nn/n.nn hh:mm:ss 
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22. Load (IPL) MAINT’s virtual reader: 


ip! 60c clear @ 


MSG FROM MAINT : CSIINI134I systemname has nnnnnn 
bytes of available common free storage 
HCPNSS440I Named Saved System (NSS) systemname 
was successfully saved in fileid fileno 


PRT FILE fileno SENT FROM MAINT PRT WAS fileno This message indicates that the GCS load map file 


RECS nnnn CPY 001 NOHOLD NOKEEP has been sent to MAINT’s virtual printer. If you 
plan to save or print the GCS load map, record 
fileno. 

23. IPL 190: 
ip! 199 


DMSWSP327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

i 

Ready; T=n.nn/n.nn hh:mm:ss 


Note: If necessary, purge your reader to free spool space. 


| Saving and Printing the GCS Load Map | 


24. The GCS load map has been sent to MAINT’s virtual printer. To save the load map on disk, issue the 
following commands: 


query prt all @ 

OWNERID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT fileno A PRT nnnnnnnn 001 NONE mm/dd hh:mi:ss SYSPROG 

Ready; T=n.nn/n.nn hh:mm:ss The GCS load map is the file with a blank 
filename and filetype. It has approximately 2,200 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUP level. 


Note the fileno of this file. You will use it in your 
next command. 


#cp transfer prt fileno to * rdr Mi 
access 495 d 
receive fileno fn ft d 


You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as 1 —9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 
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Once you have the load map saved on disk, you can print a copy of it by issuing the following command: 


| print fn ft d @ 


Pe ee oe End of Saving and Printing the GCS Load Map se 


| Installing Multiple GCS Systems | 


25. You can install more than one GCS system, if you defined the additional systems in the system directory. 
To install each additional system: 
a. Reestablish the minidisk access order: 
access 5E5 b Hf 


vmfsetup 56643089 gcs (all @ 
erase 56643089 $setup a 


b. Set up the GROUP EXEC messages in storage (full-screen display devices only): 


| copyfile csimes[y] [text|txtnnnnn] fm csiume[y]text a Mf 


| The CSIMES text file is shipped as TXTnnnnn. The most current version of this file can be 
| determined by referring to the first entry in the CSIMES AUX file. In the first entry, there is a 
| UMnannn field, where nnnnn is the PTF number. 


| Note: If you have not received service on the CSIMES text file, you do not have a CSIMES file 
| with a filetype of TXTnnnnn. You will have one with a filetype of TEXT. 


set language langid (add csi user @ 


c. Create a configuration file for each nucleus. 
e If you are using a full-screen display device, issue: 
group systemname @ systemname is a unique filename. Then 


complete the GCS panels to define the system 
parameters. 


e If you are not using a full-screen display device, refer to the VM/XA SP Group Control System 
Command and Macro Reference. Use the build macros to create the configuration file. 


d. Remove the temporary GCS message file from user storage and erase it from your A-disk (full-screen 
display devices only): 


set language langid (delete csi user @ 
erase csiume[y| text a 


e. For each new GCS system, add a DEFSYS statement to the SAMPNSS EXEC. For information on 
the DEFSYS command, see the VM/XA SP CP Command Reference. 
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f. For each new GCS system, add an override section at the end of the product parameter file. This 
example shows an override section for a GCS system called NEWGCS: 


:NEWGCS. GCS 

:BLD. REPLACE 

NEWGCS VMFBDNUC BUILD1 
> END. 


You must also add the name of the new GCS system to the :OVERLST. tag at the top of the 
product parameter file, for example: 


sOVERLST. CORCP CORCMS CORGCS NEWGCS 


g. For each GCS system, assemble the configuration file, build and save the new GCS nucleus, and 
copy the text deck, configuration file, ASSEMBLE file, and EXEC to the 495 disk: 


access 5E5 b & 
vmfsetup 56643089 gcs (all @ 
erase 56643089 $setup a 


itask build gcs systemnane @ 
access 495 d @ 

copy systemname text a = = 
erase systemname text a 
copy systemname group a = = d (replace @ 
erase systemname group a @ 

copy systemname assemble a = = d (replace Mf 
erase systemname assemble a 

ip] @0c clear @ 

ip] cms @ 


d (replace @ 


Before you build another GCS nucleus, save or print the GCS load map, as indicated above. 
Remember to give each load map file a different name. 


fe es ae End of Installing Multiple GCS Systems ee ae eee, 
26. Verify that all your GCS segments were defined correctly: 


query nss all 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS = fileno NSS. R_=nnnn mm/dd hh:mm:ss GCS NSS MAINT 
*NSS fileno NSS R= nnnn mm/dd hh:mm:ss systemname NSS MAINT 


27. When you complete your GCS installation, go to “Step 27. Save CMS” on page 192. 
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Step 27. Save CMS 


In this step, you will save CMS as a named saved system in 370 mode and 370-XA mode, at default 


addresses. 


This step takes approximately 10 minutes. 


Note: For general information about CMS as a named saved system, see VM/XA SP Planning and 


Administration. 
1. Make sure: 


e You are logged on as MAINT. 


e You have finished loading all files to the 190 and 19E minidisks. After this step, any change to files 


on these disks requires resaving CMS. 


e You have 16 megabytes of virtual storage. To determine your storage size, issue QUERY 
VIRTUAL STORAGE. If you have less than 16 megabytes, issue DEFINE STORAGE I6M. 


e CMS is running. If not, load CMS by issuing IPL 190 CLEAR. Wait for the CMS version 
identification to appear on the screen. Then press ENTER. 


2. Invoke the SAMPNSS EXEC: 


Sampnss cms cmsxa Hf 


HCPNSD440I Named Saved System (NSS) CMS was 
successfully defined in 
fileid fileno 


HCPNSD440I Named Saved System (NSS) CMSXA was 


successfully defined in 
fileid fileno 
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The SAMPNSS EXEC issues the DEFSYS 
command. 


Note: If you use “CMS” (the default name) for 
the System/370 name, users will receive the 
new level of CMS each time they issue the 
command [PL CMS. 


The SAMPNSS EXEC first issues the DEFSYS 
command to define a skeleton system data file for 
CMS and for CMSXA. These messages tell you 
the DEFSYS commands were successful. 


The names shown in the SAMPNSS command are 
the default names for the System/370 (CMS) and 
for the 370-XA (CMSXA) systems. Of course, 
you may name these systems whatever you wish: 
but if you change the names you must either edit 
the SAMPNSS EXEC to use your names or define 
your systems manually. 


Note: The names are positional on the command 
(the System/370 name followed by the 
370-XA name). 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) S— nnnn mm/dd hh:mm CMS NSS MAINT 
*NSS nonn NSS) S— nnnn mm/dd hh:mm CMSXA NSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


The SAMPNSS EXEC tissues a QUERY NSS 
command. These messages show what system 
data files are defined. 


. Issue the QUERY NSS ALL MAP command to make sure CMS is defined properly. Check whether the 
information under BEGPAG, ENDPAG, TYPE, and CL in the response to QUERY NSS ALL MAP is 
the same as shown. 


query nss all map @ 
FILE FILENAME FILETYPE MINSIZE BEGPAG ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


nnnn CMS NSS 000256K Q0000 OO000A EW S Q0000 OMITTED NO 
00020 00022 EW 
OOEOO OOFFF SR 

nnnn CMSXA NSS 000256K 00000 O000A EW S 0000 OMITTED NO 
00020 00022 EW 
QOEOO QOOFFF SR 

Ready; T=n.nn/n.nn hh:mm:ss 


. Set your machine mode to 370, load CMS (IPL 190), and save the CMS system: 


set machine 370 & If your machine is already in 370 mode, you will 
SYSTEM RESET not get a response. 

SYSTEM = 370 

ip] 190 clear parm savesys cms @ Load 190 with the option to save the system under 


the name CMS. 


HCPNSD440I Named Saved System (NSS) CMS was 
successfully saved in fileid fileno 
DMSWSP327I The installation saved segment could not be loaded 
Disregard the message about not loading the saved 
segment; CMS has been successfully saved as a 
named saved system. 


VM/XA CMS 5.6 mm/dd/yy hh:mn If you have changed the version heading, your 
own heading will appear. 
ies Press ENTER to initialize CMS. 


SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 


. Set your machine mode to XA, load CMS (IPL 190), and save the CMSXA system: 


set machine xa @ If your machine is already in 370-XA mode, you 
SYSTEM RESET do not get a response. 
SYSTEM = XA 
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ip] 190 clear parm savesys cmsxa Mf Load 190 with the option to save the system under 
the name CMSXA. 


HCPNSD440I Named Saved System (NSS) CMSXA was 
successfully saved in fileid fileno 
DMSWSP327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm Disregard the message about not loading the saved 
segment; CMSXA has been successfully saved as a 
named saved system. 


a Press ENTER to initialize CMS. 
SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


6. Set your machine mode to 370 (or XA), redefine your virtual storage to 2 megabytes, and load the CMS 
(or CMSXA) named saved system. The example below shows loading CMS in System/370 mode: 


set machine 370 @ If your machine is already in 370 mode, you will 
SYSTEM RESET not get a response. 
SYSTEM = 370 


define storage 2m & 


STORAGE = 2M Defining storage causes a system reset. 
Storage cleared - system reset 

ip] cms @ 

DMSINS327I The installation saved segment could not be loaded 

VM/XA CMS 5.6 mm/dd/yy hh:mm 


ra After receiving the CMS version identification, 
SYNONYM SYM press ENTER to complete CMS or CMSXA 
CP TERM MODE VM initialization. 


Ready; T=n.nn/n.nn hh:mm:ss 


7. Check the CMS status by issuing QUERY NSS ALL and QUERY NSS ALL MAP. Check whether the 
information under FILENAME and FILETYPE in the response to QUERY NSS ALL is the same as 
shown. Also, check whether the information under BEGPAG, ENDPAG, TYPE, and CL in the 
response to QUERY NSS ALL MAP Is the same as shown. The system data file should now have class 
A (rather than S) and have one user (MAINT). 


query nss all @ 
OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS A nnnn mm/dd hh:mm:ss CMS NSS MAINT 


*NSS nonnn NSS A nnnn mm/dd hh:mm:ss CMSXA NSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
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query nss all map @ 


FILE FILENAME FILETYPE MINSIZE BEGPAG ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


nnnn CMS NSS 000256K 00000 
00020 
Q0E00 
nnann CMSXA NSS 000256K 00000 
00020 
00E00 
Ready; T=n.nn/n.nn hh:mm:ss 


0000A 
90022 
OOF FF 
B000A 
90022 
OOF FF 


EW 
EW 
SR 
EW 
EW 
SR 


A 00001 OMITTED NO 


A 00000 OMITTED NO 


. Redefine your storage before you continue with the following steps: 


define storage l6m @ 

STORAGE = 16M 

Storage cleared - system reset 
ip] 196 clear @ 


DMSINS327I The installation saved segment. could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm 
cs 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 
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Step 28. Install the CMSDOS, CMSBAM, CMSVSAM, and CMSAMS 
Saved Segments 


If you plan to use the CMS/DOS environment or the VSAM product, you must install the CMSDOS, 
CMSBAM, CMSVSAM, and CMSAMS saved segments. 


If you do not want to install these saved segments, go to “Step 29. Create the CMSINST and HELP 
Saved Segments” on page 204. 


In this step, you will: 


e¢ Install CMSDOS and CMSBAM in separate saved segments 
e Create a CMSVSAM segment and install the VSAM product tape 
e Create a CMSAMS segment and install Access Method Services. 


This step takes approximately | hour. 


Warning: The CMSDOS and CMSBAM segments must be installed before you install CMSVSAM and 
CMSAMS. 


Note: For more information about saved segments, see VM/XA SP Guide to Saved Segments. 


1. IPL 190. This is the CMS system disk. 


define storage l6m @ 

STORAGE = 0016M 

STORAGE CLEARED - SYSTEM RESET 

ip] 190 clear @ 

DMSINS327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm Your own installation header appears if you have 
** DO NOT press ENTER! ** taney 

access (noprof @ This command suppresses execution of MAINT’s 
Ready; T=n.nn/n.nn hh:mm:ss PROFILE EXEC. 

access 193 e Access the disks with installation and service 
access 5E5 b @ EXECs, and the DOSGEN EXEC. 

Ready; T=n.nn/n.nn hh:mm:ss 

set emsg on Mf You want to see any and all error messages during 
Ready; T=n.nn/n.nn hh:mm:ss execution of the installation EXEC. 


2. Define a segment into which the DOSGEN EXEC can load CMSDOS: 


defseg dosinst 900-90f sr Ml This command defines a 1M segment for 
HCPNSD440I Saved segment DOSINST was DOSINST starting at 900000. You may place this 
successfully defined in fileid segment anywhere below the segment spaces 
fileno defined for CMSDOS. CMSBAM, CMSVSAM., 
Ready; T=n.nn/n.nn hh:mm:ss and CMSAMS. 
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3. Invoke the DOSGEN EXEC with a load address and the name DOSINST. The load address used for 
DOSINST in this example is 900000. 


dosgen 900000 dosinst Ml The load address and name are those 

HCPNSS4401 Saved segment DOSINST was recommended for the DOSINST segment. Error 
successfully saved in fileid messages for the DOSGEN EXEC are listed on 
fileno page 198. 


PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 

DMSWGN715I DOSGEN COMPLETE 

Ready; T=n.nn/n.nn hh:mm:ss 


4. IPL CMS: 


ip] cms 

DMSINS3271I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

is 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


5. Define CMSDOS, CMSBAM, CMSAMS, and CMSVSAM: 


set sysname cmsdos dosinst @ 
Ready; T=n.nn/n.nn hh:mm:ss 


sampnss cmsdos i 
HCPNSD440I Saved segment CMSDOS was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nnnn NSS A nonn mn/dd hh:mm:ss DOSINST DCSS MAINT 
*NSS nnnn NSS) S_— nnnn mm/dd hh:mm:ss DOSBAM — DCSS MAINT 
*NSS nnnn NSS) S— nnnn mm/dd hh:mm:ss CMSDOS — DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


Sampnss cmsbam 
HCPNSD440I Saved segment CMSBAM was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS S— nnnn mm/dd hh:mm:ss CMSBAM — DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


sampnss cmsams 
HCPNSD440I Saved segment CMSAMS was successfully 
defined in fileid fileno 
OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS S_— nnnn mm/dd hh:mm:ss CMSAMS — DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
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sampnss cmsvsam Bf 
HCPNSD440I Saved segment CMSVSAM was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS S— nnnn mn/dd hh:mm:ss CMSVSAM  DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


Invoke the DOSGEN EXEC with a load address and the name CMSDOS. The load address set up by 
SAMPNSS is B00000 for the name CMSDOS. 


access 193 e 
Ready; T=n.nn/n.nn hh:mm:ss 


dosgen b00000 cmsdos Mf The load address and name are those 
HCPNSS440I Saved segment CMSDOS was successfully recommended for the CMSDOS segment. Error 
saved in fileid fileno messages for the DOSGEN EXEC are listed on 


PRT FILE fileno SENT FROM MAINT PRT AS fileno page 198. 
RECS nnnn COPY 001 A NOHOLD NOKEEP 

DMSGEN715I DOSGEN COMPLETE 

Ready; T=n.nn/n.nn hh:mm:ss 


. To save the load map, rename it and copy it to the alternate LOCAL minidisk (395): 


access 395 d @ 

DMSACC724I 395 replaces D(395) 
Ready; T=n.nn/n.nn hh:mm:ss 

copy load map a cmsdos segmap d @ 
Ready; T=n.nn/n.nn hh:mm:ss 


Error Messages from DOSGEN 


If DOSGEN detects an error in the address that you specified: 
DMSGENO95E INVALID ADDRESS 


If DOSGEN cannot find a read/write accessed A-disk: 
DMSGENOQ6E NO READ/WRITE A-DISK ACCESSED 


If DOSGEN finds unresolved external references while loading the text files: 
DMSGEN111E DOSGEN FAILED DUE TO LOAD ERRORS 


If DOSGEN detects an error while assigning the storage key or saving the segment: 
DMSGEN412S DOSGEN FAILED DUE TO SETKEY ERRORS 


DMSGEN141S DOSGEN FAILED DUE TO SAVESYS ERRORS 
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8. Replace the name CMSBAM in the CMS SYSNAME table with any name that is not a name previously 
used as a segment name: 


set sysname cmsbam sysname # The SET SYSNAME command enters an 

Ready; T=n.nn/n.nn hh:mm:ss alternate name for CMSBAM in the SYSNAME 
table. Choose a name that was not used 
previously as a segment name. This command 
does not actually change the saved segment’s 
name, but keeps CP from finding and IPLing the 
segment at the wrong time. 


9. Place your CMS virtual machine in a CMS/DOS environment, then invoke SAMGEN to load the 
CMSBAM segment. You must give the EXEC an address at which to load the CMSBAM segment; this 
address also must match the address in the skeleton CMSBAM segment that you defined beforehand. 


set dos on @ This command places your virtual machine in a 
CMS/DOS environment. 


DMSSET400I SYSTEM systemname DOES NOT EXIST You may receive these informational messages. 
DMSSET1101I 100K DOS partition defined sysname 1s the name you chose in substep 8. 
at hexadecimal location 020000. 
Ready; T=n.nn/n.nn hh:mm:ss 
samgen @ 
DMSSGN363R ENTER LOCATION WHERE CMSBAM 
WILL BE LOADED AND SAVED: 


b1000e8 

DMSSGN364I FETCHING CMSBAM... 

DMSFET710I Phase DMSVBM entry point at location B100CO. 
DMSSGN366R ENTER NAME OF SYSTEM TO BE SAVED: 

cmsbam 


HCPNSS440I Saved segment CMSBAM was successfully The messages indicate that the segment has been 
saved in fileid fileno loaded and saved. 

DMSSGN365I SYSTEM CMSBAM SAVED 

Ready; T=n.nn/n.nn hh:mm:ss 


10. Set DOS off: 


set dos off @ 
Ready; T=n.nn/n.nn hh:mm:ss 


11. Define and format a minidisk for VSAM files. 


a. Map your USER DIRECT and examine the map to find a space for the new minidisk. Look for a 
gap of appropriate size and record the starting cylinder of that gap. The number of cylinders needed 
depends on the DASD type: 


Device Cylinders Needed 


3350 15 cylinders 
3375 22 cylinders 
3380 14 cylinders 
3390 14 cylinders 
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access 295 d Refer to the directory map to find a gap. 


Ready; T=n.nn/n.nn hh:mm:ss Repeat the locate command as many times as 
diskmap user direct @ necessary. When you find a suitable gap, note 
File USER DISKMAP A has been created. the starting cylinder and DASD label the 
Ready; T=n.nn/n.nn hh:mm:ss cylinders reside on and leave the file. 


xedit user diskmap Mf 
locate/GAP 

qquit @ 

Ready; T=n.nn/n.nn hh:mm:ss 


. XEDIT your directory and add an entry for the new minidisk: 


xedit user direct Hf 


locate/USER MAINT @ Locate the MAINT minidisk definitions. 
locate/MDISK @ 
input 


MDISK vdevno devtype startcyl cyls label MW ALL Hf 


vdevno, devtype, and label are the address, device 
type, and label of the DASD volume where the 
new minidisk is located. startcyl is the starting 
cylinder of the gap where the new minidisk is 
defined. cyls is the number of cylinders needed 
for the minidisk. 


z Press ENTER to return to the command line. 
file 


. Map the directory again and examine the map to make sure that the new minidisk was created in the 


place you specified and that it does not overlap any existing minidisks: 


diskmap user direct 


. Issue DIRECTXA to update the directory and bring it online: 


directxa user @ 

VM/XA SYSTEM PRODUCT USER DIRECTORY CREATION PROGRAM - RELEASE 2.1 
EOJ DIRECTORY UPDATED AND ONLINE 

Ready; T=n.nn/n.nn hh:mm:ss 


. Link to the new minidisk: 


link * vdevno vdevno @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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f. Format the new minidisk: 


format vdevno v (blksize 2648 

DMSFOR603R FORMAT will erase all the files on disk V(vdevno). 
Do you wish to continue? 
Enter 1 (YES) or 0 (NO). 

1 of 

DMSFOR605R Enter disk label: 

label @ 

DMSFOR733I Formatting disk V 

DMSFOR732I nn cylinders formatted on V(vdevno) 

Ready; T=n.nn/n.nn hh:mm:ss 


g. Access the new minidisk as A: 


access vdevno a @ 
Ready; T=n.nn/n.nn hh:mm:ss 


Set DOS on: 

set dos on @ You may receive these informational messages. 
DMSSET4001 SYSTEM systemname DOES NOT EXIST sysname is the name you chose in substep 8 on 
DMSSET1101I 100K DOS partition defined page 199. 


at hexadecimal location 020000. 
Ready; T=n.nn/n.nn hh:mm:ss 


. Mount the VSAM product tape on a tape drive attached to MAINT at virtual address 181. (If you do 


not have the proper class authority to attach a tape, the system operator may have to do it for you.) 


Invoke VSAMGEN EXEC: 


vsamgen 
SELECT ONE OF THE FOLLOWING FUNCTIONS BY ENTERING THE NUMBER: 
1. INSTALL AMS (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
2. INSTALL VSAM (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
3. INSTALL VSAM AND AMS (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
4. BUILD AMS (BUILD DOSLIB, CREATE SEGMENT) 
5. BUILD VSAM (BUILD DOSLIB, CREATE SEGMENT) 
6. BUILD VSAM AND AMS (BUILD DOSLIB, CREATE SEGMENT) 
7. RESTART AMS (CREATE SEGMENT) 
8. RESTART VSAM (CREATE SEGMENT) 
9. RESTART VSAM AND AMS (CREATE SEGMENT) 
10. QUIT (EXIT VSAMGEN EXECUTION) 


ENTER RESPONSE... 


Choosing option 3 tells the EXEC to create both CMSVSAM and CMSAMS segments as new segments. 
If this is the initial installation of VSAM, select function 1, 2, or 3. 


If the text files have already been created from the VSAM product tape and are currently on the accessed 
A-disk, select function 4, 5, or 6. 


If the DOSLIBs currently reside on an accessed disk, select function 7, 8, or 9. In this case, it is not 
necessary to have the text files available. 
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DMSVGN365R ONE OR MORE OF THE TEXT FILES LISTED IN THE BOTH EXEC 
ARE MISSING. THE VSAM PP PID TAPE SHOULD BE ON TAPE DRIVE 181 
TO RESTORE THE FILES. ENTER: 
'GO' IF TAPE DRIVE IS READY TO LOAD FILES, 
'QUIT' TO STOP GENERATION PROCESS. 
go 


Messages from VSAMGEN 


While VSAMGEN is processing, you may receive error and information messages. These messages 
are self-explanatory. Messages labeled 21011 are information messages from the linkage editor and 
may be ignored. 


Respond to the EXEC messages as they appear: 


DMSVGN3621I LINK-EDITING CMSVSAM ... 
DMSVGN363I CMSVSAM DOSLIB CREATED ON DISK 'A'. 
DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER ‘QUIT’. 
go & 
DMSVGN363R ENTER LOCATION WHERE CMSVSAM SHARED WILL BE 
LOADED AND SAVED: 


ba0000 


DMSVGN363R ENTER LOCATION WHERE CMSVSAM NONSHARED WILL BE 
LOADED AND SAVED: 
a30000 


DMSVGN364I FETCHING CMSVSAM ... 

DMSFET7101I PHASE DMSVVS ENTRY POINT AT LOCATION nnnnnn 

DSMVGN371R CMSVSAM IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
'CP' MODE, APPLY THE ZAPS AND THEN REPLY 'GO' 

go & 

DMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


cmsvsam This name is the default name with which the 
segment was defined. 


DMSVGN365I SYSTEM CMSVSAM SAVED. 


DMSVGN368R ERASE CMSVSAM DOSLIB ? ... ENTER 'YES' OR 'NO': 
no 


DMSVGN362I LINK-EDITING CMSAMS ... 
DMSVGN363I CMSAMS DOSLIB CREATED ON DISK 'A'. 
DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER 'QUIT'. 
go @ 
DMSVGN363R ENTER LOCATION WHERE CMSAMS SHARED WILL BE 
LOADED AND SAVED: 
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b46000 This is the recommended location. 
DMSVGN363R ENTER LOCATION WHERE CMSAMS NONSHARED WILL BE 
LOADED AND SAVED: 

adeeed 

DMSVGN364I FETCHING CMSAMS ... 

DMSFET710I PHASE DMSVAS ENTRY POINT AT LOCATION nnnnnn 

DMSFET7101 PHASE DMSVAN ENTRY POINT AT LOCATION nannnn 

DMSFET710I PHASE DMSVAX ENTRY POINT AT LOCATION nnnnnn 

DMSVGN371R CMSAMS IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
'CP' MODE, APPLY THE ZAPS AND THEN REPLY 'GO' 

go 

DMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


cmsams This name is the default name used for defining 


the segment. 
DMSVGN365I SYSTEM CMSAMS SAVED. 
DMSVGN368R ERASE CMSAMS DOSLIB ? ... ENTER ‘YES' OR 'NO': 


no @ 
Ready; T=n.nn/n.nn hh:mm:ss 


You may now purge the DOSINST named saved segment: 


query nss all @ 
OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) A nnann mm/dd hh:mm:ss DOSINST DCSS MAINT 


Ready; T=n.nn/n.nn hh:mm:ss 


purge nss fileno @& fileno is the file identifier for DOSINST. 


No files purged 

0001 file pending purged 
Ready; T=n.nn/n.nn hh:mm:ss 
set dos off Mf 

Ready; T=n.nn/n.nn hh:mm:ss 
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Step 29. Create the CMSINST and HELP Saved Segments 


In this step, you will: 


Define a segment to contain EXECs and System Product Editor macro instructions 
Use the DCSSGEN command to load and save the CMSINST segment 
Save the HELP file directory in a saved segment. 


Notes: 


1. You must have the NAMESAVE HELP statement in your user directory in order to save the 
HELP file directory information in a saved segment. 


See “Step 21. Update the User Directory” on page 71. 


. If the HELP segment is defined as a member of a segment space, you must have a NAMESAVE 
statement (for example, NAMESAVE INSTHELP) in the directory entry for the user who 
invokes SAVEFD. SAVEFD specifies the name of the segment space. 


This step takes approximately 20 minutes. 


Note: For more information about saved segments, see VM/XA SP Guide to Saved Segments. 


1. Log on as MAINT (unless you are continuing from the previous step). 


2. Check your virtual storage. If it is less than 16M, issue the following: 


define storage l6m @ 
STORAGE CLEARED - SYSTEM RESET 
STORAGE = 0016M 


3. IPL CMS: 


ip! cms @ 
DMSWSP327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm If you have changed the version heading, your 
own heading will appear. 


a Press ENTER to complete the CMS initialization. 
SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


4. Use the SAMPNSS EXEC to define a segment for CMSINST: 


Note: If you have increased the number of entries in the CMS load list, be sure that the DEFSEG entry 
for CMSINST in the SAMPNSS EXEC has enough pages defined to accommodate the increased 
size. 


sampnss cmsinst 
HCPNSD440I Saved segment CMSINST was successfully 
defined in fileid fileno 
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OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nnnn NSS  S—sonnnn mm:dd hh:mm INSTHELP DCSS MAINT 
*NSS nnnn NSS) S—onnnn mm:dd hh:mm CMSINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


The EXEC issues a QUERY command that 
displays information about the segments defined 
for named saved systems. 


. Define the HELP segment: 


sampnss help @ 
HCPNSD440I Saved segment HELP was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS) So nann mm:idd hh:mm INSTHELP DCSS MAINT 
*NSS nonn NSS S— nnnn mm:dd hh:mm CMSINST DCSS MAINT 


*NSS nonnn NSS) S-— onannn mn:dd hh:mm HELP DCSS MAINT 
Ready; T=n.nn/n.nn hh:mn:ss 


. Save both segments: 


saveseg cmsinst Mm Each member saved segment defined by 
HCPNSS440I Saved segment CMSINST was SAMPNSS must be saved separately. 
successfully saved in fileid 
fileno 


Ready; T=n.nn/n.nn hh:mm:ss 

saveseg help @ 

HCPNSS440I Saved segment HELP was successfully 
saved in fileid fileno 

Ready; T=n.nn/n.nn hh:mm:ss 


. Redefine each segment to create the skeleton segments: 


sampnss cmsinst 
HCPNSD440I Saved segment CMSINST was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS §S— nnnn mm:dd hh:mm CMSINST OCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


sampnss help @ 
HCPNSD440I Saved segment HELP was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS) S_— nnnn mn:dd hh:mm CMSINST DCSS MAINT 


*NSS nnnn NSS S— nnnn mm:dd hh:mm HELP DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
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8. If you do not want to use the sample load list, CMSINST EXECLIST, for the DCSSGEN command, use 
the System Product Editor (XEDIT) to create your own load list: 


xedit instlist file a @ 


input Hf 
* Rename RDRLIST EXEC to MAIL EXEC This is a sample. Enter the load list entries you 
RDRLIST EXEC * MAIL = need. 


FILELIST EXEC S$ 
SYSPROF EXEC S$ 
PARSE XEDIT S$ 

DISCARD EXEC $ 


Only one comment line per list is allowed; it must 
be the first line. For more information on 
creating this list, see “DCSSGEN Command” on 


NOTE EXEC S peeoaey 

PROFNOTE XEDIT S The remainder of the lines contain entries for 

ALL XEDIT S frequently used EXECs and Editor macros; 
multiple users can share the same executing copy 
of these EXECs and macros. 

| Press ENTER to return to the command line. 

file 


9. The load list must have a fixed record length in order for you to use the DCSSGEN command. If your 
load list has variable length records, change it to a fixed length file by issuing: 


copyfile fn ft fm = = = (recfm f Irecl 80 replace @ 


10. Invoke the DCSSGEN command: 


access 193 e Bf Jn ft fm is the file ID of the file that contains the 

dcssgen fn ft fm cmsinst Ml list of EXECs and Editor macros to be loaded into 
the segment, either CMSINST EXECLIST fm or 
your own file (for example, INSTLIST FILE A). 


CMSINST is the name of the segment you want 
to create. It is also the default name of the 
installation saved segment in the DMSNGP 
profile. If you changed the name in the 
DMSNGP profile, or specified a different name in 
response to the installation questions (see page 
152), use that name instead. If you do not specify 
a segment name, the DCSSGEN command 
defaults to CMSINST. 


HCPNSS440I Saved segment CMSINST was successfully 
saved in fileid fileno 
Ready; T=n.nn/n.nn hh:mm:ss 
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The DCSSGEN command creates a load map file. CMSINST DCSSMAP A. For the sample load list 
created in substep 8 on page 206, the load map would look like this: 


* RENAME RDRLIST EXEC TO MAIL EXEC 

RDRLIST EXEC * MAIL = 
15:41:59 10/22/85 copy of RDRLIST EXEC S loaded as MAIL EXEC 
EXISBLK - 280000 BLOCK - 280100 LENGTH - 001C40 

FILELIST EXEC $ 
15:41:58 10/22/85 copy of FILELIST EXEC S loaded as FILELIST EXEC 
EXISBLK - 280020 FBLOCK - 281D40 LENGTH - 6018C8 

SYSPROF EXEC S 
7:30:18 11/26/85 copy of SYSPROF EXEC S loaded as SYSPROF EXEC 
EXISBLK - 280040 FBLOCK - 283608 LENGTH - 002178 

PARSE XEDIT S$ 
8:47:55 12/18/84 copy of PARSE XEDIT S loaded as PARSE XEDIT 
EXISBLK - 280060 FBLOCK - 285780 LENGTH - 0024A0 

DISCARD EXEC §$ 
15:40:32 10/22/85 copy of DISCARD EXEC S loaded as DISCARD EXEC 
EXISBLK - 280080 FBLOCK - 287C2Q LENGTH - 001280 

NOTE EXEC S 
11:03:53 10/24/85 copy of NOTE EXEC S loaded as NOTE EXEC 
EXISBLK - 280@A0 FBLOCK - 288EDO LENGTH - 605310 

PROFNOTE XEDIT S 
15:41:55 10/22/85 copy of PROFNOTE XEDIT S loaded as PROFNOTE XEDIT 
EXISBLK - 2800CQ FBLOCK - 28E1E0 LENGTH - 000980 

ALL XEDIT $ 
15:41:05 10/22/85 copy of ALL XEDIT S$ loaded as ALL XEDIT 
EXISBLK - 2800E@ FBLOCK - 28EB60 LENGTH - 001298 
*** End of Source List *** 
CMSINST built at 15:56:34 on 12/02/85 


Note: When you built your CMS nucleus, if you indicated in the DMSNGP file (USEINST = YES) or in 
answer to the DMSINQ296R prompt that you wanted to use the installation segment (the default 
is YES), then this segment is used each time a user IPLs CMS. If you previously indicated that 
you did not want to use the installation segment but now want to use it, you must modify the 
DMSNGP file to indicate that the segment should be used, then assemble the modified DMSNGP 
and rebuild CMS. (To find the latest version of the DMSNGP file, issue SETUP to access all the 
minidisks where it might be; then issue FILELIST DMSNGP ASSEMBLE *. All the copies of 
DMSNGP ASSEMBLE will be listed, with the date when each one was last modified.) 
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Messages from DCSSGEN 


While DCSSGEN is processing, you may receive error or warning messages that indicate specific 
conditions. If errors were encountered, after processing is complete you receive the following prompt: 


DMSEXG298R An error has been detected while building the DCSS. 
Do you still want the DCSS saved? 
Enter 1 (YES) or © (NO). 


Enter 1 to disregard the errors and save the segment, or enter 0 to not save the segment. If you do 
not save the segment, you receive the message: 


DMSEXG288I segname not saved 

If DCSSGEN encounters an error while saving the segment, you receive the message: 

DMSEXG288E dcssname not saved 

If your virtual machine is not large enough to contain the segment (you need 16M), you receive the 
message: 

DMSEXG284E The DCSS is not completely inside the virtual machine 


To correct this situation, increase the size of your virtual machine, re-IPL CMS, and reissue the 
DCSSGEN command. 


11. Define your virtual storage less than the address at which the HELP segment is to be loaded. For 
example, if the HELP segment is defined at X'C50000' (the default address in the SAMPNSS EXEC) 
define your storage as 12M. 


define storage 12m Mf 
STORAGE CLEARED - SYSTEM RESET 
STORAGE = 12M 


12. Re-IPL CMS: 


ip! cms @ 

DMSWSP327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

| 


SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 


13. Issue the following commands to initialize and save the segment: 


(For more information about using the SAVEFD command to save minidisk file directory information in 
a saved segment, refer to VM/XA SP CMS Command Reference.) 


savefd init vaddr label help vaddr is 19D for mixed-case American English, 
Ready; T=n.nn/n.nn hh:mm:ss 19C for uppercase American English. 


savefd save vaddr label help @ 
label is the CMS label assigned to the disk. (The 


DMSACP723I Z(19D) R , 
(19D) R/O labels in the sample directory are MNT19D and 
HCPNSS440I Saved segment HELP was successfully MNT19C.) 


saved in fileid fileno 
Ready; T=n.nn/n.nn hh:mm:ss 
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14. Verify that the CMSINST and CMSHELP segments were defined correctly: 


15. 


query nss all @& 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS = fileno NSS A_ nnnn mm/dd hh:mm:ss INSTHELP NSS MAINT 


*NSS = fileno NSS A_nnnn mm/dd hh:mm:ss CMSINST NSS MAINT 
*NSS = fileno NSS A_nnnn mm/dd hh:mm:ss HELP NSS MAINT 


The system data file should now have class A (rather than S) and have one user (MAINT). 


Redefine your storage before you continue: 


define storage l6m @ 


STORAGE = 16M 

Storage cleared - system reset 
ipl] cms 

VM/XA CMS 5.6 mm/dd/yy hh:mm 
| 


SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 30. Back Up the Named Saved System Files 


In this step, you will back up all the named saved systems, including CMS, on tape. 


This step takes approximately 10 minutes. 


Mount a scratch tape with ring on an available 3420, 3422, 3430, or 3480 tape drive, or insert a cartridge 
with the tab protector set to off in an available 3480 tape unit. Follow machine operations manuals to 


mount the tape. 


e Do not attach the tape unit to MAINT. 


e The tape must be suitable for a 3420, 3422, 3430, or 3480 tape unit. 


Issue the SPTAPE command to dump the CMS system data file to tape: 


sptape dump vdevno nss all run @ 


DUMPING vdevno NSS *NSS nonn A 


SPTAPE DUMP FUNCTION ON DRIVE vdevno 
COMPLETE 
Ready; T=n.nn/n.nn hh:mm:ss 


Substitute the virtual device number of the tape 
drive for the value vdevno. The operand run 
specifies that the SPTAPE rewinds and unloads 
the tape after the operation. 


The messages from SPTAPE tell you that the file 
is being dumped to tape. The CMS ready message 
may occur between the messages. 


. Store the tape for emergency use. If it is ever necessary, you can use this tape and the SPTAPE 


command to restore the CMS system data file. For more information about the SPTAPE command, see 


VM/XA SP Real System Operation. 


To restore your CMS named saved system: 


I. 
z 
3: 
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Log on as MAINT. 
Mount the backup tape on a tape drive. 
Issue: 


sptape load vdevno nss all run @ 
LOADING vdevno NSS *NSS nnnn A NOW nann 


LOADING vdevno NSS *NSS nnnn A NOW nonn 
SPTAPE LOAD FUNCTION ON DRIVE vdevno COMPLETE 


IPL CMS: 


ip] cms 

VM/XA CMS 5.6 mn/dd/yy hh:mm 
a 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 
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Step 31. Store a Backup Copy of CP on Tape 


In this step, you will use DDRXA to store a backup copy of CP on tape. The time to perform this step 


varies based on the device and contention for the device’s channel. It may take up to 30 minutes. 


1. Mount a scratch tape (with ring) on a tape drive. Follow machine operations manuals to mount the 
tape. 


2. Attach the tape drive to MAINT at virtual device number 0181: 


attach vdevno * 181 Hf The ATTACH command attaches the virtual 
TAPE Q181 ATTACHED device (vdevno) to MAINT’s virtual machine at 
Ready; T=n.nn/n.nn hh:mm:ss virtual device number 0181. 


3. Load the DDRXA utility to tape. If your tape drive can operate at a density of 6250 BPI, enter the 
commands under 3a. Otherwise, enter the commands under 3b. 


a. If your tape drive can operate at a density of 6250 BPI, enter these commands: 


tape modeset (tapl den 6250 M@ Set the tape density to 6250 BPI. If you receive 

Ready; T=n.nn/n.nn hh:mm:ss message DMSPAR6272E, reissue the TAPE 
MODESET command. 

filedef in disk ip] ddrxa s @ Because this step uses the MOVEFILE 

Ready; T=n.nn/n.nn hh:mm:ss command, you must first use the FILEDEF 

filedef out tapl (den 6250 command to establish data definitions for files 

Ready; T=n.nn/n.nn hh:mm:ss to be copied. 


movefile in out & 
Ready; T=n.nn/n.nn hh:mm:ss 


Go to substep 4. 


b. If your tape drive cannot operate at a density of 6250 BPI, enter these commands: 


filedef in disk ip] ddrxa s @ Because this step uses the MOVEFILE 
Ready; T=n.nn/n.nn hh:mm:ss command, you must first use the FILEDEF 
filedef out tapl @ command to establish data definitions for files 
Ready; T=n.nn/n.nn hh:mm:ss to be copied. 


movefile in out @ 
Ready; T=n.nn/n.nn hh:mm:ss 


4. Change MAINT’s virtual processor configuration to 370-XA architecture: 


set machine xa @ Setting the virtual machine to 370-XA architecture 
System reset causes a reset as if you entered SYSTEM CLEAR. 
System = XA If your machine is already in 370-XA mode, you 


will not get a response. 
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ip] cmsxa 

VM/XA CMS 5.6 mm/dd/yy hh:mm 
a 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


5. Rewind the scratch tape on virtual device number 0181: 


rewind 181 
Rewind complete 


6. Load (IPL) the tape and answer the prompts from DDRXA: 


ip] 181 clear @ Wait a few moments for DDRXA to prompt you. 
If a prompt does not appear, press the ENTER 
key. 


VM/XA SYSTEM PRODUCT DASD DUMP/RESTORE PROGRAM 
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS 


ENTER: 

sysprint cons Mf This first control statement tells DDRXA that you 

ENTER: want program messages sent to your console. 

input vdevno devtype xasres Ml The second control statement is the input control 

ENTER: statement. vdevno is the virtual address of the 
system residence volume. (The virtual address in 
the sample HCPSYS ASSEMBLE file and USER 
DIRECT is 123.) devtype is the DASD type of 
this volume. 

output 181 devtype (mode 6250 compact @ This control statement specifies the device to 

ENTER: which you are dumping the system. 


If your tape drive is not operating at 6250 BPI 
density, omit the mode 6250 compact option on 
this command. 


dump cpvol @ The statement DUMP CPVOL dumps cylinder 0 
and all PERM and DRCT DASD space from the 
system residence volume to the tape. 


DUMPING XASRES These are informational messages. GMT means 
DATA DUMPED mm/dd/yy Greenwich Mean Time. 
AT hh.mm.ss GMT FROM XASRES 
RESTORED TO SCRATCH 
INPUT CYLINDER EXTENTS QUTPUT CYLINDER EXTENTS 
START STOP START STOP 
0000 nnann 0000 nonnn 
END OF DUMP 
BYTES IN nnnnnnnnnn BYTES OUT nannnannnnn 
TRACKS NOT COMPACTED ON TAPE - nannannnnn 


The exact cylinder extents vary according to the 
device type. 


ENTER: When DDRXA finishes, it prompts you with 
| ENTER. To end the program, press the ENTER 
END OF JOB key. 
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You now have a loadable tape of the system. If you need to use this backup copy to restore CP, perform 
these steps on a first-level system: 


1. Mount the backup tape on a tape drive. 


2. Set your virtual machine to 370-XA architecture, define your virtual storage as 16 megabytes, and IPL 


CMSXA: 


set machine xa Hf 
SYSTEM RESET 


SYSTEM = XA 
define storage lém @ 
STORAGE = 16M 


Storage cleared - system reset 
ipl] cmsxa Hf 

VM/XA CMS 5.6 mm/dd/yy hh:mm 
a 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


. Perform a hardware load (IPL) of the tape device. 
. Use DDRXA to restore the system to disk: 


VM/XA SYSTEM PRODUCT DASD DUMP/RESTORE PROGRAM 
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS 
ENTER: 


sysprint cons @ 
ENTER: 


input vdevno devtype Hi 
ENTER: 


output vdevno devtype xasres 
ENTER: 


restore all 


RESTORING XASRES 
DATA DUMPED mm/dd/yy 
AT hh.mm.ss GMT FROM XASRES 
RESTORED TO XASRES 
INPUT CYLINDER EXTENTS OUTPUT CYLINDER EXTENTS 
START STOP START STOP 
0000 nnnn 0000 nnnn 


END OF RESTORE 
BYTES RESTORED nnnnnnnnnn 


ENTER: 
|_| 
END OF JOB 
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If your machine is already in 370-XA mode, you 
will not get a response. 


This first control statement tells DDRXA that you 
want program messages sent to your console. 


The second control statement is the input control 
statement. Identify the device number (vdevno) 
and tape device type (3420, 3422, 3430, or 3480) 
where the backup tape is mounted. 


This control statement specifies the DASD device 
to which you are restoring the system (XASRES). 


The RESTORE ALL statement tells DDRXA to 
restore the whole tape to the output device. 


Informational messages: GMT means Greenwich 
Mean Time. 


The exact cylinder extents vary according to the 
device type. 


When DDRXA finishes, it prompts you with 
ENTER. To end the program, press the ENTER 
key. 
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Chapter 4. Installing VM/XA System Product Release 2.1 
Using an Existing VM/SP or VM/SP HPO System 


If you have a VM/SP or VM/SP HPO system, you can use it to install VM/XA System Product Release 2.1. 
Otherwise, you must use the Starter System. See Chapter 2, “Installing VM/XA System Product Release 2.1 
with the Starter System (First Level)” on page 13 or Chapter 3, “Installing VM/XA System Product Release 
2.1 with the Starter.System (Second Level)” on page 113. 


If your VM/SP or VM/SP HPO system is running as a second-level guest of VM/XA MA, VM/XA SF, or 
VM/XA SP, some of the messages will differ from the ones shown in this procedure. 


Before You Begin 


Before you begin to install VM/XA SP, be sure to read the VM/XA SP Conversion Notebook. 


You may wish to do the following steps now. You can also do them in the order in which they appear in 
this chapter. 


e “Step 16. Convert the DMKRIO and DMKSYS ASSEMBLE Files and Tailor HCPBOX ASSEMBLE 
and the Product Parameter File” on page 254 


e “Step 19. Create the User Directory” on page 263. 
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Step 1. Make a Directory Entry for XAMAINT 


In this step, you will make an entry for the VM/XA SP installation ID CCAMAINT) in your VM/SP or 
VM/SP HPO directory. 


This step takes approximately 5 minutes. 


In order to install VM/XA SP using your existing system, you must define the VM/XA SP installation ID 
(XAMAINT) in your VM/SP or VM/SP HPO directory. 


1. Mount the first volume of the VM/XA SP product tape on a tape drive and attach the tape drive to your 
user ID as 181: 


attach vdevno * 181 


2. Get the file containing a sample directory entry for XAMAINT. (A sample XAMAINT directory entry 
for each type of DASD is printed in Appendix C, “VM/XA System Product Starter System 
Information,” after the corresponding sample directory.) Issue: 


vmfplc2 load 33xx xamaint (eof 6 @ 33xx 1s 3350, 3375, 3380, 3383 (for 3380-K), 338E 
LOADING..... (for 3380-E4), 3390 (for 3390-1), or 3391 (for 
END-OF-FILE OR END-OF-TAPE 3390-2). 


END-OF-FILE OR END-OF-TAPE 
END-OF-FILE OR END-OF-TAPE 
END-OF-FILE OR END-OF-TAPE 
END-OF-FILE OR END-OF-TAPE 
33xx XAMAINT Al 

END-OF-FILE OR END-OF-TAPE 
READY; T=n.nn/n.nn hh:mm:ss 


3. XEDIT your existing directory to add the entry for KAMAINT: 


xedit filename direct filename is the filename of your directory. 
bottom 

get 33xx xamaint @ 

set wrap on 

locate /XAMAINT Hf 


change /NOLOG/possword Change NOLOG to a password of your choice. 
file 


4. Issue the DIRECT command to bring the edited directory on line: 
direct filename 


EOJ DIRECTORY UPDATED AND ON LINE 
READY; T=n.nn/n.nn hh:mm:ss 
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Step 2. Restore the VM/XA System Product Starter System to Disk 


In this step, you will restore the starter system to disk. 


This step takes approximately 15 minutes, if you do not format any DASD. Formatting DASD volumes 
can take up to 30 minutes per volume. 


Although you are not using the Starter System to build your new VM/XA SP system, load it and restore it to 
disk now. Restoring the Starter System initializes your system residence volume. 


Warning: Do not build the VM/XA System Product system residence volume on the same volume as your 
current system residence volume. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, refer to the Program Directory that you received with the product tape for the most 
current information. 


1. Ready the DASD you plan to use. XASRES should be formatted already. If it isn’t formatted, format it 
now. 


Warning: The addresses of XASRES, XASERV (if used), XAPOO! (if used), and XAPOO2 (if used) must 
match the addresses in the HCPRIO ASSEMBLE file. If the addresses do not match, you will not be 
able to IPL your new system in Step 23. You must either convert your existing DMKRIO ASSEMBLE 
file or tailor the sample HCPRIO ASSEMBLE file in Step 16. 


2. Log on as XAMAINT: 


Warning: When you log on as XAMAINT, you must not have any packs labeled XASRES, XASERV, 
XAP001, or XAP002 online, including the ones you intend to use during the installation process. If you 
have any such packs, you will not be able to use the ones you need. If necessary, you can use the Device 
Support Facilities to relabel your packs. Issue REFORMAT UNIT(vdevno) VERIFY (oldlabel) 
VOLID(newlabel) when DSF prompts you with ENTER INPUT/COMMAND. 


logon xamaint @ 

ENTER PASSWORD 

password 

DMKLNM108E XAMAINT 124 not linked; volid XAPQ0O1 not mounted 
OMKLNM108E XAMAINT 125 not linked; volid XASERV not mounted 


DMKLNM108E XAMAINT 126 not linked; volid XAPQQ2 not mounted 


You will see this message only if you are using 
3350 DASD. 


DASD 390 linked R/O, R/W by MAINT, R/O by OPERATOR 
LOGON AT hh:mm:ss 
Device 190 does not exist 


3. Enter: 


terminal mode vm @ 
spool console * start Hf 
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IPL CMS: 


define 390 196 B 

DASD 190 DEFINED 

ip] 196 clear @ 

DMSINS327I The installation DCSS could not be loaded 
VM/SP RELn mm/dd/yy hh:mm 

8 

DMSACP1135 A(191) NOT ATTACHED 

Ready; T=n.nn/n.nn hh:mm:ss 


. Attach the volume that will become your VM/XA SP system residence volume (XASRES) to 


XAMAINT: 
vary online vdevno Wf vdevno is the virtual device address of XASRES. 
vdevno VARIED ONLINE 


attach rdevno * rdevno is the real device address of XASRES. 
DASD vdevno ATTACH TO XAMAINT vdevno 


. Attach a tape drive to XAMAINT as 181: 


attach rdevno * 181 Hf rdevno is the real device address of the tape drive. 
TAPE rdevno ATTACH TO XAMAINT 181 


. Mount the VM/XA SP Starter System tape on the tape drive. 
. Restore the VM/XA SP Starter System to disk: 


tape fsf B This command bypasses the first tape file, which 

READY; T=n.nn/n.nn hh:mm:ss contains the Device Support Facilities and the 
DDRXA program. Do not try to bypass this file 
by IPLing the tape, since DDRXA will not run in 


370 mode. 
ddr 
ENTER: 
sysprint cons B 
ENTER: 
input 181 devtype @ 181 and devtype are the virtual address and the 
ENTER: device type (3420, 3422, 3430, or 3480) of the tape 
drive where the starter system tape is mounted. 
output vdevno 33xx scratch @ vdevno is the virtual address of XASRES. 33xx is 
ENTER 3350, 3375, 3380, or 3390. 


restore all Hf 
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DMKDDR725R DASD INPUT DEVICE WAS(IS) LARGER THAN OUTPUT DEVICE 


DO YOU WISH TO CONTINUE? RESPOND YES OR NO: 

yes 

RESTORING XASRES 

DATA DUMPED mm/dd/yy at hh.mm.ss GMT 

FROM XASRES RESTORED TO SCRATCH 

INPUT CYLINDER EXTENTS 
START STOP START 
CCCC CCCC CcCcc 


END OF RESTORE 

BYTES RESTORED nannnnnnnn 
ENTER: 

a 

END OF JOB 

Ready; T=n.nn/n.nn hh:mm:ss 


OUTPUT CYLINDER EXTENTS 


Depending on the DASD model you are using, 
you may or may not see this prompt. If you do 
see it, respond yes. The starter system is designed 
to fit on all supported DASD models. 


9. When the restore is complete, detach XASRES from XAMAINT and attach it to the system: 


Note: Detach the virtual address, but attach the real address. 


detach vdevno 

DASD vdevno DETACHED 

Ready; T=n.nn/n.nn hh:mm:ss 

attach rdevno system xasres 
DASD rdevno ATTACH TO SYSTEM XASRES 
Ready; T=n.nn/n.nn hh:mm:ss 


10. Log off to bring the Starter System CMS nucleus online. 
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Step 3. Attach the VM/XA System Product Release 2.1 Product Tape 
(Volume 1) and Load the First Three Files 


In this step, you will: 


¢ Mount Volume | of the VM/XA System Product product tape on a tape drive 
e Attach the product tape drive to XAMAINT 


e Load the first three files from the product tape. 


This step takes approximately 5 minutes. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


1. Log on as XAMAINT: 


logon xamaint @ 
ENTER PASSWORD 
password @ 


THE NLSAMENG SAVED SEGMENT COULD NOT BE FOUND; Ignore this message. There is nothing wrong. 
RETURN CODE 44 FROM SEGMENT 

VM/XA STARTER SYSTEM 

Si 

SYNONYM SYN 

CP TERM MODE VM 

READY; T=n.nn/n.nn hh:mm:ss 


You are now running on the VM/XA System Product version of CMS. 


2. Mount Volume | of the VM/XA System Product product tape (in write-protect mode) on a tape drive. 
Follow the operation manual for the machine on which you mount the tape. 


3. Attach the tape drive to XAMAINT at virtual device number 0181: 


attach vdevno * 181 Mf The ATTACH command attaches the virtual 
TAPE vdevno ATTACH TO XAMAINT 181 device (vdevno) to XAMAINT’s virtual machine at 
READY; T=n.nn/n.nn hh:mm:ss virtual device number 0181. 


4. Check XAMAINT’s disk accesses. Be sure XAMAINT’s 191 minidisk is the A disk. 


query search & The QUERY SEARCH command tells you what 
MNT191 191 A R/W disks you have accessed and the alphabetic order 
MNT190 190 S R/O of those accesses. When searching for files, CMS 
READY; T=n.nn/n.nn hh:mm:ss uses the alphabetic order of accesses to create a 


search order. CMS searches the A minidisk, if 
accessed, then the B minidisk, if accessed, and so 
forth. 
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5. If XAMAINT’s 191 minidisk is not A, access that minidisk as A: 


access 191 a @ 
191 REPLACES A (195) 


READY: T=n.nn/n.nn hh:mm:ss This message would appear if the QUERY 


SEARCH command had shown MNT195 195 A 
R/W. 


. For your own convenience, set PF12 as a retrieve key. When you press the retrieve key, the last 


instruction you issued will be displayed. You need only press ENTER to enter it again. 


set pfl2 retrieve @ You may add this command to your PROFILE 
Ready; T=n.nn/n.nn hh:mm:ss EXEC. 


. Use the VMFPLC2 LOAD command to load the first three files (the tape header, memos, and 


installation tools) from the product tape to your A-disk: 


vmfplc2 load (eof 3 @ This command loads the first three tape files from 
LOADING..... the product tape. (A tape file 1s the set of files 
$TAPE$ HEADER Al between two tape marks.) These are the only tape 
END-OF-FILE OR END-OF-TAPE files you have to load—the ITASK EXEC 


automatically loads the rest of the tape. You will 
receive a message from VMFPLC2 telling you 
which files it loaded. 


SUPSP21 MEMO Al The VMSUP memo is loaded to the MAINT 191 
56643089 SERVICE Al minidisk. Read this memo before going on. 


END-OF-FILE OR END-OF-TAPE After Vou peclonn Sep 7. you may wish 16:copy 


SUPSP21 MEMO to the CP BASE disk (194 or 
394) to free space on MAINT 191. 


56643089 $PPF Al The tools in the third file are installation EXECs. 
RPWLIST DATA Al You may erase them after you finish the 
$MSG4I$ EXCAMENG Al installation, except for these files: 


$$RDPW$$ EXEC Al 
$MSG41$ EXEC Al 
SETUP EXEC Al 
SPLOAD EXEC Al e SETUP EXEC, which must remain on the 
UTILITY EXEC Al XAMAINT 191 minidisk. 


ee es, ee The DIRECTXA MODULE is loaded to 

DIRECTXA MODULE A2 

DVM PROFILE Al XAMAINT 191 now so that you can bring your 

SPLOAD PROFILE Al directory online in Step 4. It is erased after it is 
used, then reloaded to XAMAINT 190 in Step 7. 

END-OF-FILE OR END-OF-TAPE ; 

READY; T=n.nn/n.nn hhemmess If you need to reissue ITASK ALLOCATE, you 
: ; have to rewind the tape and issue VMFPLC2 

LOAD DIRECTXA MODULE A (EOT to reload 
the DIRECTXA MODULE from Volume | of the 
product tape. 


e DIRECTXA MODULE, which ts erased 
during the installation procedure 


Chapter 4. Installing VM/XA SP Using an Existing System 221 


Step 4. Invoke the ITASK EXEC 


In this step, you will use the ITASK EXEC to: 


e Provide a password for user IDs MAINT and OPERATOR 
e Load the sample directory and system definition files 
¢ Format the XASERV, XAPO00I, and XAP002 volumes. 


The time for this step depends upon the devices involved. It usually takes at least 30 minutes for each 
pack you format. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


Note: A description of the ITASK EXEC and its operands can be found in “ITASK EXEC” on page 611. 


1. Make your DASD volumes available for use; issue the following command for each volume except 
XASRES: 


vary online vdevno @ vdevno is the first-level virtual address of the 
volume; this address functions as a “real”’ address 
at second level. 


2. Issue ITASK ALLOCATE to supply a password for MAINT and OPERATOR and to format the 
XASERV XAPO01, and XAP002. volumes. 


ITASK EXEC issues the DIRECTXA command after prompting you for passwords for MAINT and 
OPERATOR. The user ID running the ITASK EXEC should not have a link to the SYSRES volume for 
the first-level system. 


Note: The example in this manual uses a 3380 DASD for the minidisks. If you use a 3350, 3375, 
3380-E4, 3380-K, or 3390, your space allocations and starting address for CMS will differ. 


itask allocate @ 


REWIND COMPLETE These are informational messages to tell you how 
DMSACC724I 191 REPLACES A (191) the operation is progressing. xx is 50, 75, 80, 8E, 
REWIND COMPLETE 83, 90, or 91, according to your DASD type. 


DMSWTK4091I LOADING 33xx * TQ 191 ATTACHED TO XAMAINT 


Note: If ITASK exits with return code 1040, the 123 full-pack minidisk is not attached. The virtual 
address of XASRES is 123. You may have to reattach XASRES to your system. 
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3. When prompted, enter a new password to be used as both the MAINT and OPERATOR passwords for 
your new VM/XA SP system: 


ENTER ONE PASSWORD FOR MAINT AND OPERATOR: You must supply a single password to be used for 


password @ 


both the MAINT and OPERATOR user IDs. 

The ITASK EXEC will XEDIT the user directory 
and replace NOLOG with the logon password that 
you provide here. 


When selecting a password, refer to the RPWLIST 
DATA file shown in Appendix F, “Restricted 
Logon Passwords” on page 859. This file 
contains all of the restricted passwords for your 
VM/XA SP2.1 system. You cannot choose a 
password for MAINT and OPERATOR that 
exists in this file. 


ENTER PASSWORD AGAIN TO VERIFY: 


passers Reenter the password that you have designated for 
the MAINT and OPERATOR user IDs. 
YOU NEED TO REMEMBER THIS 
PASSWORD FOR USE IN LATER STEPS. 
You can write it down on the worksheet—see 
Table 1 on page 7. 
VM/XA SYSTEM PRODUCT USER DIRECTORY CREATION These first messages signify that the user directory 
PROGRAM - RELEASE 2.1 has been created. Then ITASK loads the system 
EQJ DIRECTORY UPDATED generation tools needed next. 
DMSWSL970I FORMATTING XAMAINT 193 MINIDISK 
DMSWSL409I LOADING SYSGEN TOOLS TO THE 193 DISK ATTACHED TO XAMAINT 
DMSWSL970I FORMATTING XAMAINT 295 MINIDISK These are messages from ITASK as it loads files 
DMSWSL4091I LOADING HCPSYSxx * TO THE 295 DISK from the product tape. The time the ITASK 
ATTACHED TO XAMAINT EXEC needs to execute varies from system to 
DMSWSL409I LOADING HCPRIOXA * TO THE 295 DISK system. 


DMSWSL4091 


DMSWSL9701 
DMSWSL4091 


DMSACC724] 
DMSWTK9651 


DMSWTK9811 
DMSWTK9821 


ATTACHED TO XAMAINT 

LOADING HCPBOX * TO THE 295 DISK 
ATTACHED TO XAMAINT 

FORMATTING XAMAINT 395 MINIDISK 

LOADING CMSLOC SAMPLES TO THE 395 DISK 
ATTACHED TO XAMAINT 

191 REPLACES A (191) 


YOU MAY WISH TO TAILOR THE FOLLOWING Instead of tailoring the sample files, you will 


FILES BEFORE NUCLEI GENERATION: probably want to convert the system definition 

files from your current system. To do this, consult 
HCPRIO ASSEMBLE VM/XA SP Conversion Notebook. You will have 
HCPBOX ASSEMBLE a chance to do this before generating the nucleus. 
HCPSYS ASSEMBLE You do not need to do it now. 


DMSNGP ASSEMBLE 
USER DIRECT 


WHAT IS THE REAL ADDRESS OF YOUR XASERV VOLUME? 
TYPE: REAL ADDRESS OR SKIP 
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vdevno or skip @ Enter the virtual address, vdevno, of the XASERV 
volume. Refer to your worksheet (Table | on 
page 7) for the label and address of this system 
volume. Check that you typed the right address 
before you press ENTER. 


If you do not want to use XASERV., or if you 
have already formatted it, enter skip. 


DASD vdevno ATTACHED TO XAMAINT 301 


CPFMTXA: 
FORMAT WILL ERASE CYLINDERS 0000-nnnn ON DISK 301 
DO YOU WANT TO CONTINUE ? (YES | NO) You need not answer; the EXEC answers YES. 


FORMAT IN PROGRESS ON DISK 301 
CYLINDERS 0 THROUGH 49 FORMATTED 


CYLINDERS nnnn THROUGH nnnn FORMATTED 


FORMAT COMPLETE This message signifies that CPFMTXA has 
CURRENT ALLOCATION completed formatting the XASERV volume. 
TYPE CYLINDERS 

PERM 0000-nnnn 

ENTER ALLOCATION DATA 

TYPE CYLINDERS 

CURRENT ALLOCATION 

TYPE CYLINDERS 

PERM 0000-nnnn 

ALLOCATE COMPLETE 

VOLUME LABEL IS NOW 'XASERV' 


HCPFAM384I CPFMTXA COMPLETE The HCPFAM384I message signals the 
DASD vdevno DETACHED XAMAINT 0301 completion of this sequence. 
DASD vdevno ATTACHED TO SYSTEM XASERV 


DMSWTK981I WHAT IS THE REAL ADDRESS OF YOUR XAPQ01 VOLUME? 
DMSWTK982I TYPE: REAL ADDRESS OR SKIP 


vdevno or skip @ Enter the virtual address, vdevno, to allocate the 
DASD vdevno ATTACHED TO MAINT 302 XAPOO! volume. If you are using 3350 or 3375 
CPFMTXA: DASD, you must have XAPO001. Refer to your 


FORMAT WILL ERASE CYLINDERS Q000-nnnn ON DISK 302 worksheet (Table | on page 7) for the label and 
address of this system volume. Check that you 
typed the right address before you press ENTER. 


If you do not want to use XAPOOI, or if you have 
already formatted it, enter skip. 


Note: If you do not have XAPOOI, you will 
receive this message: 


HCPLNDIO8E MAINT 0124 NOT LINKED 


when you log on as MAINT. As long as 
you are using 3380 DASD, you can ignore 
this message. 
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DO YOU WANT TO CONTINUE ? (YES | NOQ) You need not answer; the EXEC answers YES. 
FORMAT IN PROGRESS ON DISK 302 
CYLINDERS 0 THROUGH 49 FORMATTED 


FORMAT COMPLETE This message signifies that CPFMTXA has 
CURRENT ALLOCATION completed formatting the XAP00O1 volume. 
TYPE CYLINDERS 

PERM 0000-nnnn 

ENTER ALLOCATION DATA 

TYPE CYLINDERS 

CURRENT ALLOCATION 

TYPE CYLINDERS 

PERM 0000-nnnn 

ALLOCATE COMPLETE 

VOLUME LABEL IS NOW 'XAPOQ1' 


HCPFAM384I CPFMTXA COMPLETE The HCPFAM384I message signals the 
DASD vdevno DETACHED XAMAINT 0302 completion of this sequence. 
DASD vdevno ATTACHED TO SYSTEM XAPQO1 


= 3350 DASD Only 


DMSWTK981I WHAT IS THE REAL ADDRESS OF YOUR XAPOQO2 VOLUME? 
DMSWTK982I TYPE: REAL ADDRESS OR SKIP 


vdevno or skip Enter the virtual address, vdevno, to allocate the 
DASD vdevno ATTACHED TO MAINT 303 XAP002 volume. The 3350 starter system requires 
CPFMTXA: XAPO02. Refer to your worksheet (Table 1 on 


FORMAT WILL ERASE CYLINDERS 0000-nnnn ON DISK 303 page 7) for the label and address of this system 
volume. Check that you typed the right address 
before you press ENTER. 


If you have already formatted XAPO02, enter skip. 


DO YOU WANT TO CONTINUE ? (YES | NO) You need not answer; the EXEC answers YES. 
FORMAT IN PROGRESS ON DISK 303 
CYLINDERS 0 THROUGH 49 FORMATTED 


FORMAT COMPLETE This message signifies that CPFMTXA has 
CURRENT ALLOCATION completed formatting the XAP002 volume. 
TYPE CYLINDERS 

PERM 0000-nnnn 

ENTER ALLOCATION DATA 

TYPE CYLINDERS 

CURRENT ALLOCATION 

TYPE CYLINDERS 

PERM 0000-nnnn 

ALLOCATE COMPLETE 

VOLUME LABEL IS NOW 'XAPO002' 
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HCPFAM384I CPFMTXA COMPLETE The HCPFAM384I message signals the 
DASD vdevno DETACHED XAMAINT 0303 completion of this sequence. 
DASD vdevno ATTACHED TO SYSTEM XAPO02 


Lind of 3350 DASD Only __—‘“‘“‘“‘C;*™SC‘*d 


READY; T=n.nn/n.nn hh:mm:ss This message tells you that the ITASK EXEC has 
completed the sequence for each volume needed 
for installing VM/XA System Product Release 2.1. 


226 Installation and Service 


Step 5. Format the Remaining Base CP Minidisks 


In this step, you will use the ITASK EXEC to format the remaining minidisks that are defined in the CP 
directory, but have not yet been formatted or loaded in a previous step. 


The time to perform this step may vary, but a good estimate is 45 minutes. 


1. Issue SET ECMODE ON to insure that all the minidisks defined will be recognized: 


set ecmode on & 

CP ENTERED; DISABLED WAIT PSW '00020000 00000000 ' 
1p] 190 clear @ 

VM/XA STARTER SYSTEM 

a 

SYNONYM SYN 

CP TERM MODE VM 

READY; T=n.nn/n.nn hh:mm:ss 


2. Use the ITASK EXEC with the BASEIDS parameter to format, load, and add (as appropriate) 
PROFILE EXECs to the remaining minidisks in the base CP directory. If you issue ITASK BASEIDS 
from a user ID other than XAMAINT, it will format that user ID’s minidisks instead of XAMAINT’s. 


Note: The block sizes of the 190 and 490 minidisks have increased from 1K B to 4KB for minidisk 
caching. The Starter System defines the 190 and 191 minidisks (formatting the 191 disk with a 
1KB block size), while the ITASK BASEIDS step formats all other minidisks with a 2KB block 
size. 


If you choose to format a minidisk with a block size of 4K B, the number of cylinders for that minidisk 
may have to be increased, as 1s the case with the HELP disks. 


itask baseids Mi 
DMSWTK1310I DO YOU WANT TO FORMAT MINIDISKS: 
AUTOLOG1 (191), CMSBATCH (195), DISKACNT (191), 
XAMAINT 36E (PVM), EREP (191), AND OPERATNS (191)? 
DMSWTK8Q05R TYPE: 1 (YES) OR O (NO). 


0 wf You cannot format these minidisks now. If you 
answer yes, your existing system’s minidisks will be 
formatted. You must format your new system’s 
minidisks after the new system is brought online. 


DMSWTK9861 THE FOLLOWING MINIDISKS 
DEFINED IN THE BASE CP DIRECTORY 
WILL BE FORMATTED: 


XAMAINT 292 XAMAINT 490 
XAMAINT 194 XAMAINT 49D 
XAMAINT 19C XAMAINT 501 
XAMAINT 19D XAMAINT 591 
XAMAINT 19E XAMAINT 592 
XAMAINT 201 XAMAINT 593 
XAMAINT 291 XAMAINT 594 
XAMAINT 293 XAMAINT 595 
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XAMAINT 294 XAMAINT 596 
XAMAINT 391 XAMAINT 59E 
XAMAINT 392 XAMAINT 5E5 
XAMAINT 393 XAMAINT 691 
XAMAINT 394 XAMAINT 692 
XAMAINT 423 XAMAINT 791 
XAMAINT 490 XAMAINT 892 
XAMAINT 491 XAMAINT 895 
XAMAINT 492 XAMAINT 896 
XAMAINT 495 XAMAINT 89E 
DMSWTK970I FORMATTING XAMAINT 292 MINIDISK 
DMSWTK970I FORMATTING XAMAINT 194 MINIDISK 
DMSWTK97QI FORMATTING XAMAINT 19C MINIDISK 
DMSWTK970I FORMATTING XAMAINT 19D MINIDISK 


DMSWTK970I 
DMSWTK970I 
DMSWTK9701 
DMSWTK9701 
DMSWTK970I 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK970I 
DMSWTK9701 
. DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK970I 
DMSWTK9701 
DMSWTK970I 
DMSWTK9701 
DMSWTK970I 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK970I 
DMSWTK970I 
DMSWTK9701 
— DMSWTK970I 
DMSWTK970I 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK9701 
DMSWTK970I 


FORMATTING XAMAINT 19E MINIDISK 
FORMATTING XAMAINT 201 MINIDISK 
FORMATTING XAMAINT 291 MINIDISK 
FORMATTING XAMAINT 293 MINIDISK 
FORMATTING XAMAINT 294 MINIDISK 
FORMATTING XAMAINT 391 MINIDISK 
FORMATTING XAMAINT 392 MINIDISK 
FORMATTING XAMAINT 393 MINIDISK 
FORMATTING XAMAINT 394 MINIDISK 
FORMATTING XAMAINT 423 MINIDISK 
FORMATTING XAMAINT 490 MINIDISK 
FORMATTING XAMAINT 491 MINIDISK 
FORMATTING XAMAINT 492 MINIDISK 
FORMATTING XAMAINT 495 MINIDISK 
FORMATTING XAMAINT 49C MINIDISK 
FORMATTING XAMAINT 49D MINIDISK 
FORMATTING XAMAINT 501 MINIDISK 
FORMATTING XAMAINT 591 MINIDISK 
FORMATTING XAMAINT 592 MINIDISK 
FORMATTING XAMAINT 593 MINIDISK 
FORMATTING XAMAINT 594 MINIDISK 
FORMATTING XAMAINT 595 MINIDISK 
FORMATTING XAMAINT 596 MINIDISK 
FORMATTING XAMAINT 59E MINIDISK 
FORMATTING XAMAINT 5E5 MINIDISK 
FORMATTING XAMAINT 691 MINIDISK 
FORMATTING XAMAINT 692 MINIDISK 
FORMATTING XAMAINT 791 MINIDISK 
FORMATTING XAMAINT 892 MINIDISK 
FORMATTING XAMAINT 895 MINIDISK 
FORMATTING XAMAINT 896 MINIDISK 
FORMATTING XAMAINT 89E MINIDISK 


DASD 333 DETACHED 


READY; T=n.nn/n.nn hhemm:ss The ready message indicates that ITASK has 


completed its work successfully. 


3. If any of the minidisks listed in message DMSWTK968I were not formatted, check your work packs to 
make sure that they are labeled XASERV, XAPOOI, and XAPO002, and that they are attached to the 
system. Then reissue ITASK BASEIDS. 


4. Continue with the next step. 
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Step 6. ITASK Loads Files from the Product Tape (Volume 1) 


In this step, you will issue the ITASK EXEC to load files from Volume 1 of the product tape. 


This step takes approximately 30 minutes. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


1. Enter the ITASK command with the LOAD ALLI operands to load the CP and dump viewing facility 
object code and service files. If a problem should occur during this step, or if for some reason you want 
to return to this step and load product tape files, see “ITASK EXEC” on page 611 for how to load the 
files you need. 


itask load alll 
DMSWSL409I LOADING SYSTEM SAMPLES TO 

THE 191 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING CP OBJECT TO 

THE 194 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING CP PUTAPPLY TO 

THE 292 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING CP PUTDELTA TO 

THE 294 DISK ATTACHED TO XAMAINT 
DMSWSL4091I LOADING CP CORAPPLY TO 

THE 292 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING CP CORDELTA TO 

THE 294 DISK ATTACHED TO XAMAINT 
DMSWSL4091 LOADING DUMPVIEW OBJECT TO 

THE 193 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING DUMPVIEW PUTAPPLY TO 

THE 392 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING DUMPVIEW PUTDELTA TO 

THE 293 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING DUMPVIEW CORAPPLY TO 

THE 392 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING DUMPVIEW CORDELTA TO 

THE 293 DISK ATTACHED TO XAMAINT 
READY; T=n.nn/n.nn hh:mm:ss 


These are messages from ITASK as it loads more 
files from the product tape. The time the ITASK 
EXEC needs to execute varies from system to 
system. 
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Step 7. ITASK Loads Files from the Product Tape (Volume 2) 


In this step, you will issue the ITASK EXEC to load files from Volume 2 of the product tape. 


This step takes approximately 30 minutes. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all ot them. We recommend that you do not change any 
addresses. 


1. Mount Volume 2 of the product tape. 


2. Issue ITASK LOAD CMS to load the CMS object code, source code, and service files; and the IOCP 
files: 


itask load cms @ 
DMSWSL40Q9I LOADING CMS BASE TO 
THE 193 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING IOCP FILES TO 
THE 193 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING CMS PUTAPPLY TO 
THE 392 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING CMS PUTDELTA TO 
THE 293 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING CMS CORAPPLY TO 
THE 392 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING CMS CORDELTA TO 
THE 293 DISK ATTACHED TO XAMAINT 
DMSWSL409I LOADING CMS SYSTEM TO 
THE 190 DISK ATTACHED TO XAMAINT 


3. The ITASK EXEC invokes the SETUP EXEC to establish the minidisk access order, then the 
ASMGEND EXEC to build the system F assembler and create the associated auxiliary directory: 


DMSACC724I 191 REPLACES A (191) 


DMSACC724I 190 REPLACES A (191) 

DMSACC725I 190 ALSO = S$ DISK 

ASSEMBLE XF GEND PROC 

ENTER TARGET DISK MODE FOR ASSEMBLE MODULES 
DEFAULTS TO S-DISK IF NONE ENTERED. 


a Press ENTER to place the modules on the S-disk, 
the system default. 


Enter another disk-mode letter if you prefer the 
modules to be placed on another minidisk. 


ASSEMBLE XF GEND COMPLETE 


DMSACC724I 191 REPLACES A (190) 
READY; T=n.nn/n.nn hh:mm:ss 
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Notes: 


a. At this time, you may choose to make a copy of the documentation file (SUPSP21 MEMO) to the 
CP BASE disk as suggested in Step 3, substep 7 on page 221. 


b. You may choose to load HELP files, CP, CMS, and dump viewing facility source files, and GCS 
object files at this time. The following is an alternative order for loading these files that will 
minimize tape mounts: 


1) Load HELP files from Volume 2. (See Step 24 on page 270.) 
2) Load GCS object files from Volume 2. (See Step 28, substep 3 on page 276.) 


3) Load CP, CMS, and dump viewing facility source files from Volume 3. (See Step 25 on page 
271.) 
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Step 8. Establish the Service Tools Build Disk 


In this step, you will copy the latest level of the service tools to the service tools build disk. 


This step takes approximately 10 to 15 minutes. 


To be sure that you are using the most recent service EXECs, you must have the latest level of service on a 
service tools build disk. This disk, SES, is defined in the sample directories. It is the only disk in the TASK 
string in the product parameter file. 


1. IPL 190: 


ip! 196 clear @ 

VM/XA STARTER SYSTEM 

x 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


2. Establish the correct minidisk access order and create a work EXEC to help you copy the service tools: 
setup @ 
Ready; T=n.nn/n.nn hh:mm:ss 


DMSACC7241 vdevno replaces fm (vdevno 


vmfsetup 56643089 cms 
DMSACC724I vdevno replaces fim (vdevno 


Ready; T=n.nn/n.nn hh:mm:ss 


xedit Ivlses exec fm Hf fm is the filemode of the task disk (SES). 
input # 
&TRACE OFF Enter these lines exactly as they appear. 


&FT = &LEFT OF &2 2 
&FT = &CONCAT OF &FT * 
EXEC FILELIST &1 &FT * 


&EXIT 0 

& Press ENTER twice to return to the command 
ra line. 

file H 


3. Look for the latest version of the CPYSVSES EXEC or CPYSVSES EXCnnnnn. CPYSVSES contains a 
list of all the service EXECs. 


filelist cpysvses * * Hi Examine each version of CPYSVSES. CPYSVSES 
has an update history at the top. The latest level 
is one with the most updates. Use the update 
history, not the date and time stamp, to determine 
which 1s the most recent version. 
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4. Copy the latest level of CPYSVSES to the task disk (SES) with a filetype of EXEC: 


copyfile / = exec fm (olddate replace @ Issue this command from the FILELIST screen, 
Ready; T=n.nn/n.nn hh:mm:ss on the line listing the file you want to copy. 


5. Invoke CPYSVSES EXEC: 


cpysvses exec Ivlses Mf 
Ready; T=n.nn/n.nn hh:mm:ss 


6. CPYSVSES EXEC invokes LVLSES, which invokes FILELIST to display each entry for each service 
EXEC listed in CPYSVSES. Process each FILELIST screen as follows: 


a. For each of the files on the FILELIST screen, determine which 1s the latest version. Do not depend 
on the date and time stamps; examine the actual files. Each file ends with an update summary that 
indicates the file’s service history. The latest version is the one with the most service. Files with 
filetypes of EXCnannnn, MODnnnnn, XEDnnnnn, and PRFnnnnn are exact images of the 
corresponding EXEC, MODULE, XEDIT, and PROFILE executables. 


b. Copy the latest files to the task disk (SE5), using the OL.DDATE REPLACE options. Assign the 
copy a filetype of EXEC, MODULE, XEDIT, or PROFILE: 


copyfile / = ft fm (olddate replace @ Issue this command from the FILELIST screen, 
on the line listing the file you want to copy. 


c. Press PF3 to exit this FILELIST screen and go to the next screen. 
d. Continue until there are no more FILELIST screens. 


7. Look for the latest version of the product parameter file: 


filelist 56643089 * * Examine each version of the product parameter 
file. A sample product parameter file is shown in 
“A Sample Product Parameter File” on page 384. 
The product parameter file has an update history 
at the top. The latest level is the one with the 
most updates. Use the update history, not the date 
and time stamp, to determine which is the most 
recent version. 


8. Copy the latest level of the product parameter file to the task disk (5E5): 


copyfile / = $ppf fm (olddate replace @ Issue this command from the FILELIST screen, 
Ready; T=n.nn/n.nn hh:mm:ss on the line listing the file you want to copy. 


9. Now that the service tools are all on the service tools build disk, you do not need to issue SETUP again. 
Instead, simply access SES as B. You may wish to add this access to MAINT’s PROFILE EXEC. 


access 5£5 b 
Ready; T=n.nn/n.nn hh:mm:ss 


10. Check MAINT 191 (your A-disk) for files with the same filename as files on the task disk (SE5). Erase 
any duplicate files from MAINT 191 (your A-disk) so that you will not invoke any back-level service 
EXECs. 
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filelist * *b EH 
PF9 


erase 
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This command lists all the files on your B-disk. 


Pressing PF9 on the FILELIST screen lists all the 
files with the same filename as the one where the 
cursor 1S positioned, with any filetype and on all 
disks. See if there is one with the same filename 
on the A-disk. 


Enter this command on the line listing the file you 
want to erase. Be sure to erase the file only on the 
A-disk (191), not on the B-disk (SE5) or any other 
disk on which it may appear. 


Step 9. Set the System Default National Language 


In this step, you will set the system default national language. 


This step takes approximately 20 minutes. 


The system default national language is mixed-case American English. This means that most system 
messages and HELP files will appear in mixed case (capital and small letters). Some will appear in uppercase 
(capital letters only). 


Decide whether you want to keep the system default as mixed-case American English or change it to 
uppercase American English (in which case all system messages and HELP files will be in uppercase). Follow 
the appropriate instructions below. 


If you want to install a system default national language other than American English, you will be able to do 
so after you finish the installation process. See Chapter 5, “Installing a New System National Language” on 
page 311 for instructions. 


If you want to install an alternate system national language (including whichever version of American English 
is not your default), see VM/XA SP Planning and Administration. 


Mixed-Case American English 


If you want to keep the system default national language as mixed-case American English, you should 
convert the installation messages to mixed case. (If you do not do so, all the installation messages will 
continue to appear in uppercase, but most other system messages will appear in mixed case.) 


1. Save the uppercase installation message file: 


rename $msg4i$ exec a = excuceng = Hl 
READY; T=n.nn/n.nn hh:mm:ss 


2. Rename the mixed-case installation message file: 


rename $msg4i$ excameng a = exec = MI 
READY; T=n.nn/n.nn hh:mm:ss 


Notes: 
1. You may see the following message when you IPL CMS: 


DMSINS283E The NLSAMENG saved segment could not be found; 
return code 44 from SEGMENT 


This is an informational message. You can ignore it. 


2. If you receive service for $MSG4I$ EXEC, the service will be in uppercase. You do not have to convert 
it to mixed case. 
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Uppercase American English 


If you want to change the system default to uppercase American English, you must: 


l. 


tO 


Edit the product parameter file and change all :NLS. tags from AMENG to UCENG: 


xedit 56643089 $ppf mm 


ch/:NLS. AMENG/:NLS. UCENG/* * There are six blanks after :NLS. in the XEDIT 
file i change command. 


. Save DMSNGP TEXT. then rename the DMSNGP TXTUCENG file DMSNGP TEXT. This gives you 


a TEXT file assembled from a DMSNGP profile with LANGID = UCENG and HELP=19C. 


Note: You will be able to make other changes in the DMSNGP profile in Step 13, after you install 
Assembler H. You will have to change the LANGID= and HELP= parameters in Step 13. The 
DMSNGP TXTUCENG file is provided here only to allow you to specify uppercase American 
English as your system default national language. 


access 395 d @ 

DMSACC724I 395 REPLACES D(395) 
READY; T=n.nn/n.nn hh:mm:ss 

rename dmsngp text d = txtameng = @ 
READY; T=n.nn/n.nn hh:mm:ss 
rename dmsngp txtuceng d = text 
READY; T=n.nn/n.nn hh:mm:ss 


MN 
= 


. Convert SVMFMSG$ EXEC (the service message file) to uppercase: 


xedit $vmfmsg$ exec Mf 
uppercas * 
file Hf 


Notes: 


I. 


2. 
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You may see the following message when you IPL CMS: 


DMSINS283E The NLSUCENG saved segment could not be found; 
return code 44 from SEGMENT 


This 1s an informational message. You can ignore it. 


If you receive service for $VMFMSG$ EXEC, the service will be in mixed case. You will have to 
convert it to uppercase. If you receive service for the DMSNGFP profile or the product parameter file, 
you will have to update them again. 
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Step 10. Build CMS 


In this step, you will build CMS. 


This step takes approximately 5 minutes. 


l. 


Spool punch output to your own virtual reader: 


spool punch * @ 
Ready; T=n.nn/n.nn hh:mm:ss 


ip] 190 clear @ 

VM/XA STARTER SYSTEM 

« 

SYNONYM SYN 

CP TERM MODE VM 

READY; T=n.nn/n.nn hh:mm:ss 
itask build cms @ 
nonnnnnn files changed 


DMSACC724I 191 replaces A(191) 
DMSACC724I 5E5 replaces B(5E5) 


DMSWSU1900W The existing 56643089 $SETUP Al 
file has been refreshed. You 
might want to check your access 
order when done. 


LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 
PUN FILE fileno TO XAMAINT 
COPY 001 NOHOLD 


DMSWSU1906E The access of 19E failed with a 
return code of 28. Processing 
stops for product 56643089. 
The original access order cannot 
be restored. 


Ready; T=n.nn/n.nn hh:mm:ss 


vmfview build @& 


. IPL 190 and issue ITASK BUILD CMS to invoke the CMS BUILD process: 


ITASK invokes the SETUP EXEC to create the 
correct CMS access order. 


You will see this message only if you have a copy 
of 56643089 $SETUP on your A-disk. If you do 
see it, you will get return code 4. 


A temporary load list is created and the system 
loader is invoked. 


You may receive this message. It is not a 
problem. The access failed because 19E is empty. 
You will reaccess 19E when you re-IPL 190. If 
you see this message, you will get return code 4. 


If you get return code 4, the reason may be that a 
PTF now being applied has another PTF, outside 
CMS, as a prerequisite. Check the $VMFBLD 
S$ERRLOG file for message DMSBNC1854W. 


. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 
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4. Ensure that the proper files are in XAMAINT’s virtual reader: 


query rdr xamaint all @ The ALL operand requests a display of all 
information about the reader files. 

ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT = nnnn * PUN nnnnnnnn 001 NONE am/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 


Ready; T=n.nn/n.nn hh:mm:ss 
This is the file that you will IPL in substep 8 
below. It has approximately 28.000 records. The 
exact size varies according to the system default 
language, local modifications, and VMSUP level. 


. Order your reader so that the CMS nucleus will be processed first: 


order rdr fileno @ fileno is the file number of the CMS nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


. Ensure that the virtual reader is readied for class * reader files: 


query virtual 00c @ 
RDR @00C CL cl NOCONT NOHOLD' EOF READY 
Ready; T=n.nn/n.nn hh:am:ss 


. If the virtual reader is not class *, issue: 


spool rdr class * hold @ The HOLD option causes the spool file to remain 

Ready; T=n.nn/n.nn hh:mm:ss in your reader after it has been received. To 
remove this file from your reader, issue purge rdr 
fileno. To change the status of the reader file, 
issue change rdr fileno hold. fileno is the file 
number of the reader file. 


. Load (IPL) MAINT’s virtual reader: 


ip] 00c clear @ 


HCPLDR80131 Possible overlay: .SLC 000000 
DMSINS283E The NLSlangid saved segment could not be found; 
return code 44 from SEGMENT If you see either of these messages, you can ignore 
them. They are informational messages. 


DMSINQ609R Nucleus (CYL or BLK) address = 


ie Enter the correct starting cylinder address for the 
DASD type of your 190 minidisk: 
Device Cylinder Address 
3350 068 
3375 105 
3380 066 
3390 062 
DMSINQ612R Enter version identification: Press ENTER for the default version 
z identification, VM/XA CMS 5.6 mm/dd/yy hh:mm. 


You will be able to modify the default in Step 13. 
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DMSINQ612R Enter installation heading: 
es] 


Press ENTER for the default heading, VM/XA 
CONVERSATIONAL MONITOR SYSTEM. 
You will be able to modify the default in Step 13. 


DMSINS327I The installation DCSS could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm 
5 

SYNONYM SYN 

CP TERM MODE VM 


Ready; T=n.nn/n.nn hh:mm:ss 


. Log off to bring the VM/XA CMS nucleus on line. 
. Log on as XAMAINT: 


logon xamaint @ 
ENTER PASSWORD 


password @ 


DMKLNM108E XAMAINT 124 not linked; volid XAPQO1 


Informational message: The optional installation 
segment (CMSINST) is not loaded and saved until 
“Step 31. Create the CMSINST and HELP Saved 
Segments” on page 301 is completed. 


Use the password defined in your VM/SP or 
VM/SP HPO directory. 


not mounted 


DMKLNM108E XAMAINT 125 not linked; volid XASERV not mounted 
DMKLNM108E XAMAINT 126 not linked; volid XAPOOQ2 not mounted 


You will see this message only if you are using 
3350 DASD. 


DASD 390 linked R/O, R/W by MAINT, R/O by OPERATOR 


LOGON AT hh:mm:ss EDT day mm/dd/yy 
FILES: nnn RDR, nnn PRT, nnn PUN 


DMSINS327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm 
si 

SYNONYM SYN 

CP TERM MODE VM 

READY; T=n.nn/n.nn hh:mm:ss 
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Step 11. Save and Print the CMS Load Map 


In this step, you will: 


e Save a load map of CMS on the CMS LOCAL! disk 
e Print a copy of the load map. 


This step takes approximately 5 minutes. 


1. The CMS load map has been spooled to XAMAINT’s virtual printer. Ready the printer to send the 
CMS load map as a printer file: 


spool prt * nohold @ 
Ready; T=n.nn/n.nn hh:mm:ss 
close prt 


2. Identify the printer file and transfer it to your reader: 


query prt all @ 

OWNERID FILE CLASS RECORDS CPY HOLD DATE TIME DIST 
XAMAINT fileno A PRT 00006961 001 NONE mm/dd hh:mm:ss SYSPROG 
Ready; T=n.nn/n.nn hh:mm:ss 

transfer prt fileno * rdr @ 

RDR FILE fileno TRANSFERRED FROM * FILE fileno © 

0001 FILE TRANSFERRED 

Ready; T=n.nn/n.nn hh:mm:ss 


3. Identify the reader file: 


query rdr * all @ 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 
MAINT fileno M PUN nannnnnn 001 NONE mn/dd hh:mm:ss SYSPROG 


The CMS load map is the file with a blank 
filename and filetype. It has approximately 8,100 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUP level. Note the fileno of this file. You 
will use it in your next command. 


4. Bring in the file from the virtual reader to the CMS LOCALI disk: 


access 395 d @ The CMS map is loaded on the CMS LOCAL] 
Ready; T=n.nn/n.nn hh:mm:ss disk. 
receive fileno fn ft d @ 
File fn ft D received from XAMAINT at HPO 5.6 
sent as (none) (none) D 
Ready; T=n.nn/n.nn hh:mm:ss 
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You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as 1 —9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 


5. To print a copy of the CMS load map, issue: 


spool 00e to system class a Mf 
Ready; T=n.nn/n.nn hh:mm:ss 
print fn ft d & 

Ready; T=n.nn/n.nn hh:mm:ss 


6. Examine the load map for errors: 


xedit fn ft Hf 
qquit @ 
7. Issue: 


set ecmode on & 

CP ENTERED; DISABLED WAIT PSW 'Q0020000 00000000' 

ip] 190 clear @ 

DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

a 

SYNONYM SYN 

CP TERM MODE VM 

READY; T=n.nn/n.nn hh:mm:ss 


8. Continue with the next step. 
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Step 12. Install Assembler H Version 2 Program Product 


Note: IBM packages Assembler H Version 2 as a separate program product. This program product has its 
own installation procedure. 


In this step, you will: 


¢ Consult Assembler H Version 2 Prograni Product: Installation, SC26-4030 
e Install Assembler H Version 2 Program Product, VM feature 
e Install service for Assembler H Version 2. 


The time to perform this step may vary, but a good estimate is 20 minutes. 


1. Before you install Assembler H, consult your IBM Support Center for the latest information on APARs. 
2. Read the /nstallation manual for Assembler H Version 2 Program Product. 


3. Refer to “Installing Program Products” the VM/XA SP2.1 Program Directory for more information on 
Assembler H. 


4. Follow the directions in the Jnstallation manual to install Assembler H Version 2. IBM advises you to 
install Assembler H Version 2 on the 19E minidisk. 


Note: Use the OBJECT option to assemble Assembler H CSECTS. 


5. During the installation of Assembler H Version 2, answer YES to the question “BUILD AN 
AUXILIARY DIRECTORY?” and respond Y to the question asking what mode letter you want to use 
to access the disk containing the H-Assembler modules. 


6. Erase IEV61 TEXT. If you do not erase this file, you will not be able to apply service to Assembler H. 
7. Install the latest service level of Assembler H. 


8. After you have finished installing service for Assembler H, IPL 190: 


ip] 190 clear @ 

DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

a 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


9. Check MAINT 191 (your A-disk) for files with the same filename as files on the task disk (SE5). Erase 
any duplicate files from MAINT 191 (your A-disk) so that you will not invoke any back-level service 
EXECs. 


filelist * * fm This command lists all the files on the task disk 
(SES). 
PF9 Pressing PF9 on the FILELIST screen lists all the 


files with the same filename as the one where the 
cursor is positioned, with any filetype and on all 
disks. See if there is one with the same filename 
on the A-disk. 


242 Installation and Service 


erase Enter this command on the line listing the file you 
want to erase. Be sure to erase the file only on the 
A-disk (191), not on the task disk (5E5). 


10. If any unneeded service memos exist on the MAINT 191 disk, erase them to make room for further 
processing. 
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Step 13. Tailor the DMSNGP Profile 


In this step, you will use the VM System Product Editor (XKEDIT) to tailor the CMS nucleus generation 
profile (DMSNGP). 


This step, excluding time for printing system definition files, takes approximately 15 minutes. 


1. Before proceeding with this step, read the discussion of the DMSNGP profile in VM/XA SP Planning 
and Administration, under the discussion of the DEFNUC macro. DMSNGP ASSEMBLE is a profile 


that contains CMS configuration defaults and responses to system prompts: these will become part of the 
CMS nucleus. 


2. IPL 190: 


ip! 198 clear @ 

DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

a 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


3. Access the CMS LOCALI minidisk, where DMSNGFP resides, as D: 
access 395 d @ In this example the DMSNGP file resides on the 


: 395 disk. 
Ready; T=n.nn/n.nn hh:mm:ss 


4. Save a copy of DMSNGP ASSEMBLE, so that if you make a mistake in changing it, you can go back to 
the original file: 


copyfile dmsngp assemble d = oldassem = (olddate @ 
Ready; T=n.nn/n.nn hh:mm:ss 


5. XEDIT the CMS nucleus generation profile: 
xedit dmsngp assemble Mf Within the file, you can use the normal XEDIT 


cursor-control keys, scroll keys, insert key, and 
delete key. 
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Ce emetic ttn te rn 


NGP TITLE 'OMSNGP (CMS) 
EJECT 
DMSNGP = CSECT 
DEFNUC SYSDISK=190, 
YDISK=19E, 
HELP=19D, 
LANGID=AMENG, 
DBCS=NO, 
LANGLEV=S, 
SAVESYS=NO, 
SYSNAME=CMS , 
USEINST=YES, 
INSTSEG=CMSINST, 
REWRITE=YES, 
IPLADDR=190, 
CYLADDR=? , 
IPLCYLO=YES, 
VERSTON=?, 


* Write IPL text on cyl 0 


VM/XA SYSTEM PRODUCT 5664-308' 


* § disk address 

* Y-disk address 

* Help disk address 

* Default is American English 
* Default is not a DBCS lang 
* DCSS ID for multiple DCSS 

* Using CMS in DCSS YES OR NO 
* Name of above DCSS to save 
* Using EXEC/XEDIT in OCSS 

* Name of above DCSS to save 
* Write nucleus yes or no 

* Address of where to write 

* CYL/BLK OF WHERE TO WRITE 


t+ +£¢ €£$ $+ &€ £ £F * FF F HF F H 


* VM/XA CMS 5.6 MM/DD/YY HH MM SS* 


INSTID='VM/XA CONVERSATIONAL MONITOR SYSTEM’ 


END 


6. Look at the DEFNUC defaults, and make any necessary changes. Refer to VM/XA SP Planning and 
Administration for information on the DEFNUC macro. 


Warning: Do not delete the comma at the end of each line of the DEFNUC macro but the last line. If 
you do, all the lines after the first line without a comma are ignored. 


Warning: On each line, make sure that you leave at least one blank between the comma and the 


comment. 


e Ata minimum, you should change CYLADDR =?, to indicate the starting cylinder on the MAINT 
190 minidisk at which to start writing the CMS nucleus. The appropriate starting cylinder depends 
on the device type of the DASD where the MAINT 190 minidisk is defined: 


Device Cylinder Address 


3350 068 
3375 105 
3380 066 
3390 062 


If you do not replace the question mark for the CYLADDR keyword, you receive the following 
prompt when you generate the CMS nucleus: 


DMSINI609R Nucleus (CYL or BLK) address = 


You must respond with the appropriate cylinder address. 


e If you specify YES after the SAVESYS option, you must create a skeleton named saved segment 
(NSS) before building the CMS nucleus. This segment is saved when you build CMS and IPL your 
reader. (You will get message HCPNSS4401.) 


A skeleton segment for the CMS nucleus is created by the SAMPNSS EXEC. You can also create 
your own skeleton segment with the DEFSYS command. For information on the DEFSYS 
command, see VM/XA SP CP Command Reference and VM/XA SP Virtual Machine Operation. 
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e Make sure the LANGID and HELP parameters are night for your system default national language: 


Language LANGID HELP 
Mixed-case American English AMENG 19D 


Uppercase American English UCENG 19C 


¢ Make any other changes you wish. For example, you may want to change the version identifier or 
the installation header. You must put single quotes around your version identifier and installation 
header. The character string between the single quotes can be any combination of alphanumeric 
characters. 


file = = fm @ Make your changes and file the update file on the 
CMS LOCALI (395) disk. 


Assemble the new DMSNGBFP file: 


itask assemble dmsngp @ 


° The minidisk access order is reestablished. 
DMSUPD181E No update files were found 


DMSWHM1907I Assembling DMSNGP 


Note: If an error occurs during the assembly, examine the flagged statements and correct the statements 
in error. Then continue from the beginning of this step. 


DMSWHM1909I DMSNGP TEXT A created The DMSNGP file has been assembled and placed 
on the MAINT 191 minidisk. 


8. Copy the text deck from MAINT 191 to MAINT 395, then erase it from MAINT 191: 


If 


copy dmsngp text a = = fm (replace Mf fm is the filemode of the CMS LOCAL] minidisk. 
Ready; T=n.nn/n.nn hh:mm:ss 

erase dmsngp text a 

Ready; T=n.nn/n.nn hh:mm:ss 


you did not replace the question mark for the CYLADDR keyword, when you generate the CMS 


nucleus, you will receive the following message: 


Message Appropriate Response 


DMSINI609R Nucleus (CYL or BLK) address = nannnn 
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nnnnn is the location on the 190 disk where the new 
CMS nucleus is written. Refer to the table on page 
245 to determine the correct response for your DASD 


type. 
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Step 14. ITASK EXEC Rebuilds the CMS Nucleus 


Note: Do this step only if you changed the DMSNGFP file in Step 13. 


In this step, the ITASK EXEC: 


¢ Creates a CMS nucleus 


e Places the CMS nucleus on the CMS residence disk. 


This step takes approximately 5 minutes. 


1. Spool punch output to your own virtual reader: 


spool punch * @ 
Ready; T=n.nn/n.nn hh:mm:ss 


2. Issue ITASK BUILD CMS to create the CMS nucleus. By issuing the ITASK EXEC, you will 
incorporate updated CMS text files into a new CMS nucleus. 


itask build cms B 
nnnnnnnn files changed 


DMSWSU1L90O0W The existing 56643089 $SETUP Al 
file has been refreshed. You 
might want to check your access 
order when done. 


LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


PUN FILE fileno TO XAMAINT 
COPY 001 NOHOLD 


Ready; T=n.on/n.nn hh:mm:ss 


ITASK invokes the SETUP EXEC to create the 
correct CMS access order. 


You will see this message and return code 4 only if 
you did not erase 56643089 $SETUP in Step 10. 


A temporary load list is created, and the system 
loader is invoked. 


If you get return code 4, the reason may be that a 
PTF now being applied has another PTF, outside 
CMS, as a prerequisite. Check the S3VMFBLD 
SERRLOG file for message DMSBNC1854W. 


3. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build 


4. Ensure that the proper files are in XAMAINT’s virtual reader: 


query rdr xamaint all @ 


The ALL operand requests a display of all 
information about the reader files. 
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ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

XAMAINT = nnnn * PUN nnnnnnnn 001 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 

Ready; T=n.nn/n.nn hh:mm:ss 
This is the file you will IPL in substep 8 below. It 
has approximately 28,000 records. The exact size 
varies according to the system default language. 
local modifications, and VMSUP level. 


. Order your reader so that the CMS nucleus will be processed first: 


order rdr fileno fileno is the file number of the CMS nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


. Ensure that the virtual reader is readied for class * reader files: 


query virtual 00c @ 
RDR O00OC CL cl NOCONT NOHOLD EOF READY 
Ready; T=n.nn/n.nn hh:mm:ss 


. If the virtual reader is not class *, issue: 


spool rdr class * hold @ The HOLD option causes the spool file to remain 

Ready; T=n.nn/n.nn hh:mm:ss in your reader after it has been received. To 
remove this file from your reader, issue purge rdr 
fileno. To change the status of the reader file. 
issue change rdr fileno hold. fileno is the file 
number of the reader file. 


. Load (IPL) MAINT’s virtual reader: 


ip] 00c clear @ 
HCPLDR8015I POSSIBLE OVERLAY: .SLC 000000 You may receive this message. It can be ignored. 
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Note: Each of the following prompts appears only if the corresponding statement in DMSNGP is 
missing or empty (and the DEFNUC macro contains no default value), or if the DMSNGP 
statement contains a question mark (?): 


DMSINQ606R System disk address = 


a 190 1s the default. 

DMSINQ615R Y-disk address = 

= 19E is the default. 

DMSINQ640R HELP disk address = 

a 19D is the default. 
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DMSINQ764R Language id = 
Mor langid @ 


This response identifies the /angid of your system 
national language. The default /Jangid is AMENG 
(mixed-case American English). 


DMSINQ293R Is this a DBCS language? Enter 1 (YES) or 0 (NO). 


0 & 


DMSINQ295R Language level id = 
| 


The default is 0 (NO); mixed-case American 
English is not a DBCS (Double-Byte Character 
Set) language. 


The system national language does not use a level 
ID. 


DMSINQ296R Should the installation segment be used? Enter 1 (YES) or © (NO). 


M (or 1 W)ord 


DMSINQ310R Installation segment name = 


M or segname @ 


DMSINI729R Do you want to save the system? Enter 
0 


DMSINI730R Saved system name = 


M or sysname @ 
DMSINI607R Rewrite the nucleus? Enter 1 (YES) or 
1 


DMSINI608R IPL device address = 
a 
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The installation segment is an optional shared 
saved segment, into which you can place 
frequently used EXECs and System Product 
Editor (XEDIT) macros. You install the segment 
after you install your base system, but you must 
indicate now whether or not you are going to use 
If. 


The default is 1 (YES). Enter 0 if you do not 
want to use the segment. 


This prompt appears only if you accepted the 
default (or entered 1) at the previous prompt. 


Enter a 1- to 8-alphanumeric-character name for 
the installation segment, or press ENTER to 
accept the default name, CMSINST. 


1 (YES) or 0 (NO). 
Answer 0 (NO). You will save CMS in Step 29. 


The default is 1 (YES). Warning: The default 
response to this prompt does not agree with the 
sample DMSNGP file, where SAVESYS = NO. 


You will not see this prompt if you answered 0 to 
the preceding prompt. 


The default system names are CMS and CMSXA. 
Q@ (NO). 


Enter 1 to write the CMS nucleus on the disk that 
you specify in your response to the next prompt. 


The default is the address of the system disk (190). 
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DMSINI609R Nucleus (CYL or BLK) address = 


nnn @ nnn is the location on the 190 system disk where 
the new CMS nucleus is written. Enter the correct 
cylinder/block address for your DASD type: 


Device Cylinder Address 


3350 068 
3375 105 
3380 066 
3390 062 
DMSINI610R Also IPL CYL/BLK 0? Enter 1 (YES) or @ (NO). 
1 Enter 1 to write the initial IPL text on 


cylinder/block 0 of the disk where the CMS 
nucleus is written. 


The initial IPL text is a bootstrap program that 
reads the CMS nucleus from the cylinder/block 
where the nucleus is written (as defined in your 
response to prompt DMSINI609R). The initial 
IPL text 1s always written on the same 
cylinder/block as the nucleus. If the initial IPL 
text is not also written on cylinder/block 0, you 
must specify the cylinder/block address of the 
nucleus when you issue IPL commands for this 
system. For more information, refer to the 
description of the IPL command in VM/XA SP 
CP Command Reference. 


DMSINI611R Enter version identification: The version identification is displayed each time 
that you IPL the CMS system you are now 
generating. 

M or version You can enter up to 32 descriptive characters to 


identify this version and level of CMS, or you can 
press ENTER to accept the default version 
identifier, VM/XA CMS 5.6 mm/dd/yy hh:mm. 


DMSINQ612R Enter installation heading: The installation heading appears at the beginning 
of each output file created using this CMS 
nucleus. 

M or heading & You can enter up to 64 descriptive characters to 


serve as an installation heading, or you can press 
ENTER to accept the default heading, VM/XA 
CONVERSATIONAL MONITOR SYSTEM. 


eae End of CMS Nucleus Generation Prompts and Responses se | 
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DMSINS327I The installation saved segment could not be loaded 


Informational message: The CMSINST 
installation segment is not loaded and saved until 
you complete Step 29 on page 289. 


VM/XA CMS 5.6 mm/dd/yy hh:mm This is the default version identification. If you 
= defined your own version identification, it appears 
here and each time that you IPL 190 or IPL CMS. 


SYNONYM SYN 


CP TERM MODE VM 


Ready; T=n.nn/n.nn hh:mm:ss 
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Step 15. Save and Print the CMS Load Map 


In this step, you will: 


e Save a load map of CMS on the CMS LOCAL] disk 
e Print a copy of the load map. 


This step takes approximately 5 minutes. 


1. The CMS load map has been spooled to XAMAINT’s virtual printer. Ready the printer to send the 
CMS load map as a printer file: 


spool prt * nohold @ 
Ready; T=n.nn/n.nn hh:mm:ss 
close prt # 


2. Identify the printer file and transfer it to your reader: 


query prt all 

OWNERID FILE CLASS RECORDS CPY HOLD DATE TIME DIST 
XAMAINT fileno A PRT 00006961 001 NONE mm/dd hh:mm:ss SYSPROG 
Ready; T=n.nn/n.nn hh:mm:ss 

transfer prt fileno * rdr @ 

RDR FILE fileno TRANSFERRED FROM * FILE fileno 

Q001 FILE TRANSFERRED 

Ready; T=n.nn/n.nn hh:mm:ss 


3. Identify the reader file: 


query rdr * all @ 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 
MAINT  fileno M PUN nnnnnnnn 001 NONE mm/dd hh:mm:ss SYSPROG 


The CMS load map is the file with a blank 
filename and filetype. It has approximately 8,300 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUP level. Note the fi/eno of this file. You 
will use it in your next command. 


4. Bring in the file from the virtual reader to the CMS LOCALI disk: 


access 395 d @ The CMS map ts loaded on the CMS LOCAL] 
Ready; T=n.nn/n.nn hh:mm:ss disk. 
receive fileno fn ft d Hf 
File fn ft D received from XAMAINT at HPO 5.6 
sent as (none) (none) D 
Ready; T=n.nn/n.nn hh:mm:ss 
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You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymidd represents the date in four digits: last digit of the year, month (represented as 1 —9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 


5. To print a copy of the CMS load map, issue: 
spool 00e to system class a @ 
Ready; T=n.nn/n.nn hh:mm:ss 


print fn ft d @ 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Examine the load map for errors: 


xedit fn ft @ 
locate /TXT @& 


qquit # 


7. Continue with the next step. 
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Step 16. Convert the DMKRIO and DMKSYS ASSEMBLE Files and 
Tailor HCPBOX ASSEMBLE and the Product Parameter File 


In this step, you will: 


e Convert your current system’s real I/O configuration and system definition sample files to files for 
your new system 


e Tailor the HCPBOX ASSEMBLE file if you wish to use your own logo instead of the default logo 
that appears on your screen when you log onto the system or the default logo that appears on 
separator pages 


e¢ Assemble the HCPRIO, HCPSYS, and HCPBOX files 


¢ Tailor the product parameter file only if you have a reason for changing the supplied CP nucleus 
generation information. 


The time to perform this step varies depending upon the time you spend editing files. 


Convert the DMKRIO and DMKSYS ASSEMBLE Files 


Note: If you are applying updates with AUX files, follow the service procedures in Part 2, “Servicing the 
System.” 


Your current system’s DMKRIO ASSEMBLE and DMKSYS ASSEMBLE files define the unique 
configuration of your current system. You must convert them to files defining your new system: 


¢ The real I/O configuration file (HCPRIO ASSEMBLE) defines the configuration of your system 
input/output devices. 


¢ The CP system control file (HCPSYS ASSEMBLE) describes the system residence device (XASRES) and 
various system parameters. : 


For full instructions on converting these files, see the VM/XA SP Conversion Notebook. 


Note: You may find it useful to print copies of the system files for future reference. These include HCPSYS 
ASSEMBLE, HCPRIO ASSEMBLE, and your user directory (default USER DIRECT). 


The sample HCPRIO and HCPSYS were loaded to the XAMAINT 295 minidisk. Your new files should also 
reside there. 


Note: When tailoring HCPRIO, minidisk caching is not allowed for shared DASD. To control sharing on a 
device level, use the RDEVICE SHARED = YES option in HCPRIO or use the SET SHARED ON © 
FOR rdev command. These will effectively turn off minidisk caching on a device basis. We 
recommend that you set the RDEVICE macro in HCPRIO rather than using the SET SHARED ON 
FOR rdev command. 


When you convert DMKSYS ASSEMBLE to HCPSYS ASSEMBLE, be sure to compare it with the sample 
HCPSYS ASSEMBLE file. Load the VM/XA System Product Release 2.1 nucleus to the XASRES volume. 
After you have installed and tested VM/XA System Product, you can move the nucleus to the VM/SP 
system’s SYSRES volume; but you must reformat and reallocate the CP areas first. See the VM/XA SP 
Conversion Notebook for details. 
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Tailor HCPBOX ASSEMBLE 


If you want to change the design or contents of either the logo that appears when you log on to the system, 
or the logo that appears on separator pages in printed output, tailor the sample HCPBOX ASSEMBLE file. 
Do not edit HCPBOX ASSEMBLE. IBM services this file and bases the service on the version supplied. 

Use the procedure for local modifications. 


le 


bo 


4. 


Establish the appropriate minidisk access order: 


Note: When you run VMFSETUP during the install procedures, it leaves the file 56643089 $SETUP on 
your A-disk. If VMFSETUP is run while this file exists on your A-disk, you receive a return code 
of 4 and message DMSWSU1900W. You may want to erase 56643089 $SETUP after running 


VMFSETUP. 


vmfsetup 56643089 cp (all Mf 
erase 56643089 $setup a M@ 


xedit hcpxa cntrl @ 


. Verify that HCPXA CNTRL lists an auxiliary control file for local changes: 


TEXT MACS HCPGPI HCPPSI HCPOM1 HCPOM2 CPLIB DMSGPI DMSOM OSMACRO 


PAT AUXPAT TX$ * LOCAL PATCHES 


LCL AUXLCL LCL * LOCAL MODIFICATIONS 
TEXT AUXXA i 
qquit 


Edit the auxiliary control file: 


xedit hcpbox auxic]l 
input & 


ROOOOILC LCL LCO0001 *UPDATE HCPBOX LOGO @ 


a 
file = = fnll 


Create the update file and apply the updates: 


xedit hcpbox assemble (ctl hcpxa 


DMSXUP1781I Applying HCPBOX AnnnnnHP 


DMSXUP180W Missing PTF file HCPBOX RQOQOILC F5 
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HCPXA CNTRL should have a line like this one. 
The second field is the filetype of the auxiliary 
control file that points to local modifications. 


You will add your local modifications at the top 
of the file. 


In this example. ROO0O01LC is the filetype of the 
update file, and LC00001 is the local tracking 
number. The rest of the line, beginning with the 
asterisk (*), is a comment explaining the purpose 
of this modification. The text deck created when 
you assemble HCPBOX with your local 
modifications will be called HCPBOX LCLO0001. 


Press ENTER to return to the command line. 


fm is the CP LOCAL! disk (295). 


Instead of editing HCPBOX ASSEMBLE directly, 
you will apply changes to a copy of It. 


The updates supplied by IBM for HCPBOX 
ASSEMBLE are being applied. 


Your update file cannot be found because you 
have not created it yet. 
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HCPBOX ROOQO@ILC Al The system copies the source file and allows you 
lebaPoipare eek eure + exes eee wet to edit the copy. 


=> 

set serial off @ You want the source file’s sequence numbers and 
set trunc 72 continuation characters to remain unchanged. 

7 Make your changes and file the update file on the 
file = = fn CMS LOCAL! (295) disk. 


Assemble the HCPRIO, HCPSYS, and HCPBOX Assemble Files 


1. 


To assemble the HCPRIO, HCPSYS, and HCPBOX ASSEMBLE files, issue the following command for 
each file: 


itask assemble filename @ If an error occurs while assembling any of the 

: system definition files. see “Correcting Assembly 
DMSWHM1907I Assembling filename Errors.” 

DMSUPD178I Updating HCPBOX ASSEMBLE Bl You see these messages only when you assemble 
DMSUPD178I Applying HCPBOX AnnnnnHP F5 HCPBOX ASSEMBLE, and only if you updated 
DMSUPD178I Applying HCPBOX ft B5 It. 


DMSWHM1909I filename {TEXT|ft} A created 
PRT FILE fileno TO XAMAINT 

COPY 001 NOHOLD 
Ready; T=n.nn/n.nn hh:mm:ss 


Copy these text files from your A-disk to the CP LOCALI1 minidisk: 


HCPSYS ft 
HCPRIO ft 
HCPBOX ft 


access 295 d @ fm is the CP LOCAL] minidisk (295). 
Ready; T=n.nn/n.nn hh:mn:ss 

copy filename {text|ft} a = = fm (replace @ 

Ready; T=n.nn/n.nn hh:mm:ss 

erase filename {text|ft} a 

Ready; T=n.nn/n.nn hh:mm:ss 


Correcting Assembly Errors 


To correct assembly errors in system definition ASSEMBLE files, do the following: 


I. 
2 
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Examine the flagged statements. See VM/XA SP Planning and Administration for directions on coding. 


Correct the statements causing an error by editing the system definition file with the System Product 
Editor (XEDIT). 


. Reassemble the system definition file in which the change was made using the procedure in “Assemble the 


HCPRIO, HCPSYS, and HCPBOX Assemble Files.” 


. Repeat the sequence until all files assemble correctly. 
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Tailor the Product Parameter File 


The default 56643089 SPPF should be appropriate for most installations, but if your experience suggests 
changes, you can change 56643089 $PPF. (See “A Sample Product Parameter File” on page 384.) 


DO NOT alter this file unless you have a special need. 


The best way to change the product parameter file is to create an override file. To do this, see “The Product 
Parameter Override File” on page 402. 


| Use the XEDIT command to create an override file on the TASK (5E5) minidisk. See the VM/XA SP 
System Product Editor User’s Guide for information about the System Product Editor. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP EXEC, 
and the default addresses used by the ITASK EXEC must all match. If you change an address in any one of 
these places, you must change it 1n all of them. We recommend that you do not change any addresses. 


| File the override file on the TASK (5E5) minidisk. Use the XEDIT subcommand FILE. 
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| 
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Step 17. Generate the New CP Nucleus 


In this step, you will use the ITASK EXEC to build your new CP nucleus. 


This step takes approximately 20 minutes. 


The dialogs shown here are for sample use only. If you find a discrepancy between these dialogs and those you 
have on your terminal, please refer to the Program Directory that you received with the product tape for the 
most current information. 


1. Purge all unnecessary files from your reader to increase available spool space. 


2. Spool punch output to your own virtual reader: 


spool punch * @ 
Ready; T=n.nn/n.nn hh:mm:ss 


3. Invoke the ITASK EXEC to build the CP nucleus: 


itask build cp noassem Mf Use the noassem only if you have already 
assembled HCPSYS ASSEMBLE. HCPRIO 
ASSEMBLE, and HCPBOX ASSEMBLE. If you 
have not assembled these files, you must omit the 
noassem operand, so that ITASK will assemble 
them now. 


If you assemble the files here, copy the text decks 
from XAMAINT 191 to the CP LOCALI 
minidisk (295), then erase them from XAMAINT 


191. 
nonnnnnn FILES CHANGED The CP nucleus is being created. It will be sent to 
DMSACC724I 191 replaces A(191) your reader. 
LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 
PUN FILE fileno TO XAMAINT COPY 001 NOHOLD 
Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be that a 


PTF now being applied has another PTF, outside 
CP, as a prerequisite. Check the $}VMFBLD 
SERRLOG file for message DMSBNC1854W. 


4. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build @ 
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9. 


. Ensure that the proper files are in XAMAINT’s virtual reader: 


query rdr xamaint all @ The ALL operand requests a display of all 
information about the reader files. 

ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

XAMAINT nnonn * PUN nannnnnn 001 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 


Ready; T=n.nn/n.nn hh:mm:ss 
This is the file that you will IPL in substep 10 
below. It has approximately 75,000 records. The 
exact size varies according to the system default 
language, local modifications, and VMSUP level. 


. Order your reader so that the CP nucleus will be processed first: 


order rdr fileno @ fileno is the file number of the CP nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


. Ensure that the virtual reader is readied for class * reader files: 


query virtual 00c & 
RDR O00C CL cl NOCONT NOHOLD' EOF READY 
Ready; T=n.nn/n.nn hh:mm:ss 


If the virtual reader is not class *, issue: 


spool rdr class * hold @ The HOLD option causes the spool file to remain 

Ready; T=n.nn/n.nn hh:mm:ss in your reader after it has been received. To 
remove this file from your reader, issue purge rdr 
fileno. To change the status of the reader file, 
issue change rdr fi/eno hold. fileno is the file 
number of the reader file. 


Define your virtual storage as 16 megabytes. This is the maximum available on your existing VM/SP or 
VM/SP HPO system and the minimum needed to IPL your virtual reader in substep 10. 


Note: If you are generating a CP nucleus with a preferred virtual machine, XAMAINT’s virtual storage 
must be at least 4 megabytes greater than the sum of the VRSIZE, VRFREE, and RIO370 
operands in the SYSSTORE macro instruction in HCPSYS ASSEMBLE. Since you cannot have 
more than 16 megabytes of virtual storage in System/370 mode, the sum of the VRSIZE, 
VRFREE, and RIO370 operands must not be greater than 12 megabytes. You can make the sum 
larger after you initialize the system. For more information on the SYSSTORE macro 
instruction, refer to VM/XA SP Planning and Administration. 


define storage lim & 
STORAGE = 16384K 


DMKDSP450W CP entered; disabled wait 
PSW 00020000 00000000 


Load (IPL) XAMAINT’s virtual reader: 


ip] 00c clear @ 
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hh:mm:ss * MSG FROM XAMAINT : 

HCPGENSO10W NUCLEUS LOADED ON XASRES 

DMKDSP450W CP entered; disabled wait 
PSW OOOAODNCO 00609010 


Installation and Service 


The 9010 disabled wait state indicates that the CP 
nucleus was successfully loaded on the system 
residence device. 


If you receive a different disabled wait state code, 
see VM/XA SP System Messages and Codes 
Reference. 


Step 18. Save and Print the CP Load Map 


In this step, you will: 


« IPL CMS 
e Save the load map of the new CP system 
e Print a copy of the new CP load map. 


This step takes approximately 10 minutes. 


1. When you built CP, the CP load map was spooled to MAINT’s virtual printer. The load map must be 
transferred to MAINT’s virtual reader. If you have IPLed 190 since building CP, the load map may 
have already been spooled from the virtual printer to the virtual reader. 


Query the printer to see if the load map is still there. If it is, note the file number. If it is not, skip 
substep 3 and go to substep 2. 


query prt all @ 

OWNERID FILE CLASS RECORDS CPY HOLD DATE TIME DIST 

MAINT fileno A PRT nnnnnnonn 001 NONE mm/dd hh:mm:ss SYSPROG 

Ready; T=n.nn/n.nn hh:mm:ss The CP load map is the file with a blank filename 
and filetype. It has approximately 30,000 records. 
The exact size varies according to the system 
default language, local modifications, and VMSUP 
level. 


2. IPL CMS: 


ip] 190 clear @ 

DMSWSP3271 The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

= 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


| CP Load Map in Virtual Printer Only | 


3. Transfer the printer file to your reader: 


transfer prt fileno * rdr Hf 

RDR FILE fileno TRANSFERRED FROM * FILE fileno 
0001 FILE TRANSFERRED 

Ready; T=n.nn/n.nn hh:mm:ss 


Me End of CP Load Map in Virtual Printer Only bo 
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4. Access the CP LOCALI disk: 


access 295 d Ml This is the disk on which you will receive the load 
Ready; T=n.nn/n.nn hh:mm:ss map. 


. Bring in the file from the virtual reader to the CP LOCAL] disk: 


receive fileno fn ft d (replace @ This command saves the load map on the CP 
fn ft D1 created LOCAL! (295) minidisk. 
DMSRDC738I Record length is 132 bytes 
File fn ft D received from XAMAINT at HPO 5.6 
sent as (none) (none) D 
Ready; T=n.nn/n.nn hh:mm:ss 


You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as | —9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 


. To print a copy of the load map for the CP nucleus, issue: 


spool 00c class a & 
Ready; T=n.nn/n.nn hh:mm:ss 


print fn ft d & The load map is printed on your system printer. 
Ready; T=n.nn/n.nn hh:mm:ss 


. Examine the load map for errors: 


xedit fn ft Hf 


. Examine the load map for unresolved symbols. There should be no unresolved symbols. 


locate /unresol You are still in XEDIT mode. 


DMSXDC546E Target not found 
qquit @ 
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Step 19. Create the User Directory 


In this step, you will: 


¢ Create the user directory 
e Use the DIRECTXA command to update the user directory. 


The time to perform this step varies depending on the time you take to edit files. 


1. Consult the VM/XA SP Conversion Notebook for instructions on converting the directory you used with 
your VM/SP or VM/SP HPO system. 


If you prefer to edit the sample directory supplied with your new system, a copy is printed in 
Appendix C, “VM/XA System Product Starter System Information” on page 725. 


Note: All logon passwords are NOLOG and there are no MDISK passwords, except for some of 
MAINT’s minidisks. You may want to change these. 


2. Edit your directory. (If you are using the sample directory instead of your old directory as a base, you 
must access 295 as B first. The sample directory, called USER DIRECT, is on MAINT’s 295 minidisk.) 
Use the XEDIT command to edit the file. 


Make sure that none of the passwords in your directory are restricted. (For a list of restricted passwords, 
see Appendix F, “Restricted Logon Passwords” on page 859.) 


For more information about the user directory, see VM/XA SP Planning and Administration. 
3. When your changes are complete, enter file on the command line. 
4. Use the DIRECTXA command to update and place the user directory online: 


directxa user direct @ If your directory is not called USER DIRECT, 
enter your own directory name instead. 


VM/XA SYSTEM PRODUCT USER DIRECTORY CREATION PROGRAM - RELEASE 2.1 
EQJ DIRECTORY UPDATED 


. r 
Ready(0006); T=n.nn/n.nn hh:mm:ss Since you are running on a VM/SP or VM/SP 


HPO system, the directory is not brought online. 
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Step 20. Put the VM/XA System Product Stand-Alone Dump Utility 
on Tape or DASD 


In this step, you will put the VM/XA System Product stand-alone dump utility on tape or DASD. 


Because VM/XA System Product stores dumps in system data files, you cannot transport them from your 
VM/XA System Product system to your VM/SP or VM/SP HPO system. If you have a problem and need to 
back off to VM/SP or VM/SP HPO, you will need the stand-alone dump facility to examine a dump of the 
problem. 


Refer to VM/XA SP Planning and Administration for instructions on putting the stand-alone dump facility on 
tape or DASD. 
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Step 21. Prepare the CP-Owned DASD 


In this step, you will: 


¢ Reformat cylinder 0 of your CP-owned paging and spooling packs 
¢ Reallocate the packs. 


1. Shut down the system. 

. Re-IPL the system with the CP-owned paging and spooling packs offline. 
. Attach the CP-owned DASD to a virtual machine. 

. Use the CPFMTXA module to reformat only cylinder 0 of each pack. 


wm” & Ww WN 


. Reallocate each pack. 


For more information, see the VM/XA SP Conversion Notebook. 
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Step 22. Migrate Spool Files using the SPTAPE Command 


In this step, you will use the SPTAPE command to migrate spool files from your current system to your 


new system. 


You can migrate spool files, but not system files, from VM/SP or VM/SP HPO to VM/XA System Product. 
Use the CP SPTAPE command to do this. 


Note: When you migrate a spool file from VM/SP to VM/XA System Product, it loses those attributes that 
have no VM/XA System Product equivalents. Therefore, if you migrate it back, it will no longer be 
identical to the original file. 


See VM/XA SP Conversion Notebook for more information. 
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Step 23. Load the New CP Nucleus 


In this step, you will: 


e Shut down your VM/SP or VM/SP HPO system 

e Re-IML your processor to 370-XA mode. 

¢ Perform a hardware initial program load of the new CP nucleus and IPL VM/XA System Product 
with a cold start. 


This step takes approximately 10 minutes. 


I. 


Shut down the system you are now using. A class A user (usually the primary system operator) must 
issue the SHUTDOWN command. 


shutdown 

SYSTEM SHUTDOWN STARTED 

Ready; T=n.nn/n.nn hh:mm:ss 

SYSTEM WARM START DATA SAVED 

SYSTEM SHUTDOWN COMPLETE 

HCPGIR450W CP ENTERED; DISABLED WAIT 
PSW O00A0000 00000961 


. Re-IML the processor to 370-KA mode. Follow the hardware operations guide for your processor. 


. IPL the real address of your system residence device. Follow the hardware operations guide for your 


processor. 


If you are unable to IPL your system residence device, go back to “Step 2. Restore the VM/XA System 
Product Starter System to Disk” on page 217 and continue from there. 


VM/XA SYSTEM PRODUCT RELEASE 21 SERVICE LEVEL 0000; 
SYSTEM NUCLEUS CREATED ON mm/dd/yy AT hh:mm:ss, 
LOADED FROM XASRES 


KEKKKEKKKKKEKKEREREKKEKKEKEKKEKEREKEKRREKEKKEKKKKEK 


LICENSED MATERIALS - PROPERTY OF IBM* 


* * 
* * 
* 5664-308 (C) COPYRIGHT IBM CORP. 1983, * 
* 1989. ALL RIGHTS RESERVED. * 
* US GOVERNMENT USERS RESTRICTED RIGHTS - * 
* USE, DUPLICATION OR DISCLOSURE * 
* RESTRICTED BY GSA ADP SCHEDULE CONTRACT * 
* WITH IBM CORP. . 
* * 

* 

* 


* * TRADEMARK OF INTERNATIONAL BUSINESS 
* — MACHINES. 


KKEKKEKRKIKEKRKEKEKEKEEKKKEKEKKEKRKRKEKRKRKKRKKRKKKRKKKK 


HCPISU9511 CP VOLID volid NOT MOUNTED 


Note: A 9025 disabled wait state indicates that your system volume (XASRES) is not defined in the 
HCPRIO ASSEMBLE file. A 1010 disabled wait state indicates that your console is not defined 
in the HCPRIO ASSEMBLE file. . 
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4. During the initialization phase, respond cold drain to the START message: 


START ((COLD|WARM|FORCE) (DRAIN) (DISABLE) (NODIRECT) ) | (SHUTDOWN) 
cold drain @ 


NOW hh:mm:ss EDT day mm/dd/yy Note: If the clock is not set, set the TOD clock 
CHANGE TOD CLOCK (YES|NO): using standard operating procedures. 
no @ Consult VM/XA SP Real System Operation 


for those procedures. 


The directory on volume XASRES at address nnnn 
has been brought online. 

There is no logmsg data 

FILES: NO RDR, NO PRT, NO PUN 

LOGON AT hh:mm:ss EST day mm/dd/yy 


HCPCPJ951I CP volid volid not mounted volid is a DASD volume listed on the SYSCPVOL 
: macro instruction of HCPSYS. If the volume is 
not one that you are using, ignore the message. 


You are now logged on to the OPERATOR user 
ID. 


STORAGE = 0016M 
FILES 0000001 RDR, 0000001 PRT, NO PUN 


5. Define the storage that you want for the OPERATOR user ID: 


define storage 16m @ This is an example. You may define more than 
STORAGE = 16M 16M. 
STORAGE CLEARED - SYSTEM RESET 


XAUTOLOG AUTOLOG1 


XAUTOLOG EREP 
XAUTOLOG DISKACNT 


6. Enable the devices in your revised HCPRIO file: 
enable all @& 


hh:mm:ss Command complete 
terminal mode vm @ 


7. IPL 190: 


ip! 190 clear @ 

DMSWSP327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

| 


DMSACP1123E A(191) device error If you see this error message, you have not 
Ready; T=n.nn/n.nn hh:mm:ss formatted the operator’s 191 minidisk. 
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8. Format the operator’s 191 minidisk only if you have not already done so: 


format 191 a @ 

DMSFOR603R FORMAT wil] erase all files on disk A(191). 
Do you wish to continue? 
Enter 1 (YES) or © (NO). 

1 


DMSFOR605R Enter disk label: 

oprl191 & 

DMSFOR733I Formatting disk A 

DOMSFOR732I n cylinders formatted on A(191) 
Ready; T=n.nn/n.nn hh:mm:ss 


9. Disconnect from OPERATOR and log on as MAINT. 
Note: If you do not have XAPO0O1, you will receive this message: 
HCPLND1O8E MAINT 0124 NOT LINKED 
when you log on as MAINT. If you are using 3380 or 3390 DASD, you can ignore this message. 


Correcting Load Errors 


If the new CP nucleus fails to load, do the following: 


1. IPL CMS: 


ip] 199 clear @ 
PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 
DMSWSP327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm If you have changed the version heading, your 
a own heading will appear. 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


2. Access 295, then inspect the CP load map and virtual PSW. An error in loading may show up in either 
the load map or in the PSW. 


For a list of loader wait-state codes, refer to VM/XA SP System Messages and Codes Reference. 
3. Correct the error. 


4. Go back to the point where the error may have occurred. If you cannot determine where the error may 
have occurred, see “Step 12. Install Assembler H Version 2 Program Product” on page 242. 
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Step 24. ITASK Loads HELP Files from the Product Tape (Volume 2) 


In this step, the ITASK EXEC loads HELP files from Volume 2 of the product tape. 


The time this step takes varies from system to system, but a good estimate is 40 minutes. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


1. Attach your tape device as 181 and mount Volume 2 of the product tape on it. 
Follow the operation manual for the machine on which you mount the tape. 


2. Enter the ITASK command with the LOAD AMENGHLP, LOAD UCENGHLP, or LOAD HELP 
operands to load the HELP files. Should a problem occur during this step, or for some reason you want 
to return to this step and load these tape files, you can invoke the load function by entering the ITASK 
command again. 


itask load {amenghIp|ucenghIp|help;} @ The HELP files on the tape are in mixed-case 
American English: 


e Use the amenghlp operand to load the HELP 
files to the 19D disk. 


e Use the ucenghlp operand to load the HELP 
files directly to the 19C disk, then convert 
them to uppercase. Conversion takes about 
20 minutes. 


¢ Use the help operand to load the HELP files 
to the 19D disk, then copy them to the 19C 
disk and convert the copied files to uppercase. 


DMSWSL409I Loading AMENGHLP FILES to the You will see this message if you used the amenghlp 
19D disk attached to MAINT or help operand. 

DMSWSL409I Loading UCENGHLP FILES to the You will see this message 1f you used the ucenghlp 
19C disk attached to MAINT operand. 

CONVERTING HELP FILES TO UPPERCASE You will see this message if you used the ucenghlp 

Ready; T=n.nn/n.nn hh:mm:ss or help operand. 
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Step 25. ITASK Loads Source Files from the Product Tape (Volume 
3) 


In this step, the ITASK EXEC loads CP, CMS, and dump viewing facility source files from Volume 3 of 
the product tape. 


The time this step takes varies from system to system, but a good estimate is 30 minutes. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


1. Attach your tape device as 181 and mount Volume 3 of the product tape on it. 
Follow the operation manual for the machine on which you mount the tape. 


2. Enter the ITASK command with the LOAD ALL3 operands to load all the source files. Should a 
problem occur during this step, or for some reason you want to return to this step and load these tape 
files, you can invoke the load function by entering the ITASK LOAD ALL3 command again. 


itzsk load all3 @ 


DMSWSL409I Loading CP SOURCE to the These are messages from ITASK as it loads files 
394 disk attached to MAINT from the product tape. 

DMSWSL409I Loading CMS SOURCE to the 
393 disk attached to MAINT 

DMSWSL409I Loading DUMPVIEW SOURCE to the 
393 disk attached to MAINT 


Ready; T=n.nn/n.nn hh:mm:ss ITASK has finished restoring source files from 
Volume 3 of the product tape. 


| Note: Source files are not unpacked during the load. 
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Step 26. Install Environmental Record Editing and Printing 


In this step, you will: 


e Read the documentation for the Environmental Record Editing and Printing (EREP) Program 
e Follow the directions to install EREP. 


The time to perform this step may vary, but a good estimate is 15 minutes. 


Note: IBM packages the Environmental Record Editing and Printing (EREP) Program, VM Feature, 
5654-260, as a separate program product. This program product has its own installation procedure. 


1. Read the documentation for EREP: 
¢ The following memos in tape files 1 and 2 of the VMSUP EREP tape: 


— $654260B MEMO 

— F5654260 MEMO2 
— [15654260 MEMO 

— 5654260B SERVICE 


e The Program Directory for EREP, which describes the installation procedure for EREP. 
Note: This document does not come with the VMSUP tape. You must order it separately. 
e The discussion of EREP in VM/XA SP Planning and Administration. 
2. Follow the directions in the EREP Program Directory to install EREP from the VMSUP EREP tape. 
Note: You will receive messages HCPCRC8059I and HCPCRC8060I until EREP is installed. 
3. IPL 190: 


ip! 190 clear @ 
DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 


Z Press ENTER to complete CMS initialization. 


SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 27. Install the Printer Image Library 


In this step, you will install the image library for your printer and save it on tape. 


This step takes approximately 10 minutes. 


Warning: Do not attach the tape unit to MAINT. SPTAPE will attach it. If you have any other tape 
unit attached, detach it. 


Note: VM/XA System Product handles the printer image library differently from VM/SP. For a 
discussion of the differences, see the VM/XA SP Conversion Notebook. 


1. Load (IPL) 190. This is the CMS system disk. 


ip! 190 clear @ 
DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 


zg Press ENTER to complete CMS initialization. 
SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


2. Establish the correct minidisk access order: 


Note: When you run VMFSETUP during the install procedures, it leaves the file 56643089 $SETUP on 
your A-disk. If VMFSETUP is run while this file exists on your A-disk, you receive a return code 
of 4 and message DMSWSU1900W. You may want to erase 56643089 $SETUP after running 
VMFSETUP. 


access 5£5 b & 

vmfsetup 56643089 cp @ 
Ready; T=n.nn/n.nn hh:mm:ss 
erase 56643089 $setup a Ml 
Ready; T=n.nn/n.nn hh:mm:ss 


3. Invoke the IMAGELIB command. The command requires the filename of the image library (fn 
CNTRL). IBM supplies default image library control files called IMAGxxxx CNTRL, where xxxx is 
the printer number: 3800, 1403, 3203, 3211, 3262, 4245, or 4248. 


For more information about image libraries, see VM/XA SP Planning and Administration. 


imagelib libname If you use the IBM-supplied image library, 
HCPNMT247] NAMED IMAGE IMAGxxxx CREATED libname is IMAGxxxx, where xxxx is the printer 
Ready; T=n.nn/n.nn hh:mm:ss number. 


4. Check the status of the image library: 


query img all & 


Chapter 4. Installing VM/XA SP Using an Existing System 273 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*IMG nono IMG A= nnnn mm/dd hh:m: fn IMG MAINT 


Check the current state of the file (CL), the 
filename, and filetype. 


5. Issue the appropriate LOADBUF command and start the printer. See VM/XA SP CP Command 
Reference for more information. 


6. Mount a scratch tape with ring on an available 3420, 3422, or 3430 tape drive, or insert a cartridge into 
an available 3480 unit, with the thumbwheel turned until the white dot is not visible. Follow machine 
operations manuals to mount the tape. 


¢ Do not attach the tape unit to MAINT. SPTAPE will attach it. If you have any other tape unit 
attached, detach it. 
e¢ The tape is suitable for a 3420, 3422, 3430, or 3480 tape unit. 


Note: This procedure assumes the tape mode is 1600 bits per inch. 


7. Issue the SPTAPE command to dump the image library to tape: 


sptape dump vdevno img all run WW Substitute the virtual device number of the tape 
drive for the value vdevno. The operand RUN 
specifies that SPTAPE rewinds and unloads the 
tape after the operation. 


DUMPING vdevno IMG *IMG = nnnn A The message from SPTAPE tells you the file 1s 

: being dumped to tape. 

SPTAPE DUMP FUNCTION ON 
DRIVE vdevno COMPLETE 

Ready; T=n.nn/n.nn hh:mm:ss 


8. Store the tape for emergency use. If it is ever necessary, you can use this tape and the SPTAPE LOAD 
181 IMG ALL RUN command to restore the image libraries. For more information about the SPTAPE 
command, see VM/XA SP Real System Operation. 


9. If necessary, reattach your tape drive. 


274 Installation and Service 


Step 28. Load, Build, and Save GCS 


You must install the GCS (group control system) component if you plan to install SNA products or RSCS 
Version 2. Before you begin, read “Planning for the Group Control System (GCS)” on page 9. 


If you do not want to install GCS, go to “Step 30. Install the CMSDOS, CMSBAM, CMSVSAM, and 
CMSAMS Saved Segments” on page 293. 


To install GCS, you will do the following steps: 
e Load GCS from Volume 2 of the product tape. 
¢ Invoke the GROUP EXEC and complete a series of panels to create a GCS configuration file. 


Note: If you do not have a full-screen display device, you cannot use the GROUP EXEC because 
you cannot display the panels. In that case, you must build the configuration file manually, 
using the build macros described in the VM/XA SP Group Control System Command and 
Macro Reference. 


After you complete the panels, you invoke the ITASK EXEC with the BUILD GCS parameters. 
ITASK: 


— Modifies a copy of the GCS loadlist (GCSLOAD EXEC) and changes the entry that contains the 
filename of the GCS configuration file (the default is GCS) to match the filename of the 
configuration file that you just created (the default is also GCS). 

Files the modified loadlist on the MAINT 295 minidisk. The modified loadlist is used during the 
generation of the GCS named saved system. 

Renames the filetype of the GCS configuration file from GROUP to ASSEMBLE. 

Invokes VMFHASM EXEC to assemble the configuration file. 

Invokes VMFBLD EXEC with the BUILD GCS parameters to build and save the GCS nucleus. 


After you build and save the nucleus, you can save and print the GCS load map, which contains the 
storage addresses of the nucleus control sections and entry points. 


If you want to install more than one GCS nucleus, you must re-access the GCS minidisk structure 
and re-invoke the GROUP EXEC to create another GCS configuration file. Each configuration file 
must have a unique name and have an entry in the SAMPNSS EXEC. 


This step takes approximately 30 minutes for each GCS system. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


1. Attach a tape drive to MAINT. 
2. Mount Volume 2 of the product tape. 
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3. Issue ITASK LOAD GCS to load the GCS code: 


itask load gcs Hf 
DMSWSL409I LOADING GCS INTERFACE TO 
THE 190 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS OBJECT TO 
THE 595 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS PUTAPPLY TO 
THE 592 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS PUTDELTA TO 
THE 596 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS CORAPPLY TO 
THE 592 DISK ATTACHED TO MAINT 
DMSWSL409I LOADING GCS CORDELTA TO 
THE 596 DISK ATTACHED TO MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


4. IPL 190: 


ip] 196 clear @ 
DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 


rei Press ENTER to complete CMS initialization. 
SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


5. Establish the correct minidisk order: 


access 5&5 b Hf 

vmfsetup 56643089 gcs (all @ 
Ready; T=n.nn/n.nn hh:mm:ss 
erase 56643089 $setup a Mf 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Set up the GROUP EXEC messages in storage: 
Notes: 


a. If you are REBUILDING a GCS nucleus and your current configuration file does not require 
changes, you can skip this part of the step and go directly to the nucleus build operation on page 
284. 


b. If you do not have a full-screen display device, you cannot use the GROUP EXEC to build the 
configuration file. Do not set up the GCS messages in storage. Instead, refer to the VM/XA SP 
Group Control System Command and Macro Reference and use the build macros described there to 
build the configuration file manually. Then continue this step with the nucleus build operation on 
page 284. 
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copyfile csimes[y] [text|txtnnnnn| fm csiume[y |text a @ 


Ready; T=n.nn/n.nn hh:mm: 
ady; T=n.nn/n.nn hh:mm:ss y is the country code for your system default 


national language: blank for mixed-case American 
English and b for uppercase American English. 
You can use QUERY LANGLIST to determine 
your system default national language. 


The CSIMES text file is shipped as TXTnnnnn. The most current version of this file can be determined 
by referring to the first entry in the CSIMES AUX file. In the first entry, there is a field that reads 
UMnannnn, where nnnnn is the PTF number. 


Note: If you have not received service on the CSIMES text file, you do not have a CSIMES file with a 
filetype of TXTnnnnn. You will have one with a filetype of TEXT. 


This command creates a temporary GCS message file (containing the messages for the GROUP EXEC) 
that has the filename required by the SET LANGUAGE command. A permanent message file will be 
created when you generate the GCS nucleus. If there has been any service to the message file, the 
permanent file will reflect it. 


set language langid (add csi user @ langid identifies your system default national 

Ready; T=n.nn/n.nn hh:mm:ss language. At this point, /angid will be either 
ameng (mixed-case American English) or uceng 
(uppercase American English). 


This command sets the language of the temporary 
GCS message file and places the file in user 
storage. 


. Invoke the GROUP EXEC to display the configuration panels. 


Use your installation reference worksheet to help you complete the panels. For more information, see 
“Planning for the Group Control System (GCS)” on page 9. 


group systemname Wl This command assigns systemname as the filename 
of the GCS configuration file that you are creating 
and invokes the Primary Option Menu. The 
systemname parameter is optional at this time. If 
specified, it must match the system name in the 
DEFSYS entry for this GCS system in the 
SAMPNSS EXEC (the sample system name Is 
GCS). If you specify a system name here, the 
Primary Option Menu appears with the system 
name filled in. If you do not specify a system 
name here, you must specify one on the Primary 
Option Menu. 
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Table 4. Function Keys Used with the GROUP EXEC Panels 
PF1 HELP Shows ‘ormation about the panel you are looking at. 


PF2 CLEAR Clears the input areas where you enter information. 
PF3 END 


Leaves the present panel and returns you to a previous one. 


¢ If you press PF3 on the Primary Option Menu, you return to CMS. 

¢ If you press PF3 on any other screen, you return to the Primary Option 
Menu. 

¢ If you press PF3 after you have entered information, but have not saved 
it, you receive the message: 


577E File has been changed; type QQUIT to quit 
anyway 


Fills in the panel’s input areas with the values you last saved there. 


PF6 SAVE Saves information you’ve entered on the panel (for the configuration file 
systemname GROUP). 


BEY PREVIOUS 
pag VERIFY 


ENTER Processes any valid CP or CMS command typed on the command line. Two 
specific commands you can enter are: 


1. QQUIT, entered from the Primary Option Menu, returns you to CMS. 
If entered on any other panel, it returns you to the Primary Option 
Menu. 

2. CANCEL, entered on any panel, returns you to CMS. 
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GCS GROUP - PRIMARY OPTION MENU Primary 


Fill in the blanks with the required information and then press the ENTER key. 


Type/change the name of the saved system that is being defined. 
SYSTEM NAME : 
Type one number from the list below to display/update the: 
1. Authorized VM Userids. 
2. Saved System Information. 


3. Saved Segment Links. 


Type your choice here: _ 


PF: 1 HELP 2 CLEAR 3 END 
PES wets BS ee 9 VERIFY 10 


scoco> 


8. To complete the Primary Option Menu: 
a. Fill in or change the SYSTEM NAME. 


If you invoked GROUP with the systemname parameter, this panel appears with the SYSTEM 
NAME already filled in. 


b. Select the next panel (1, 2, or 3) and press ENTER. 


The first time you leave the Primary Option Menu, select panel 1; the next time, panel 2; the third 
time, panel 3. 
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AUTHORIZED VM USERIDS FOR < PAGE 1 OF 1 


To ADD, fill in the blanks with the authorized VM userids. 
To CHANGE, type a new userid over the userid to be changed. 
To DELETE, type blanks on the line. 


Pressing the ENTER key or PF6 key will save the update. 


PF: 1 HELP 2 CLEAR 3 END ... 5 REFRESH 6 SAVE 
PF: 7 PREVIOUS 8 NEXT 9 VERIFY 10... 12 ... 12 CURSOR 


F— >=} p— fo 


9. To complete the Authorized Userids panel: 
a. Type in the user IDs. 


Press ENTER or PF6 after typing the user IDs to save your information. Every time you press 
ENTER or PF6, the GROUP EXEC tells you how many user IDs it has processed. Use PF7 and 
PF8 if you have more than one screenful of user IDs. 


b. Return to the Primary Option Menu. 


Press PF3. If you forget to press ENTER or PF6, you will remain on this screen and see the 
message: 


577E File has been changed; type QQUIT to quit anyway 


To continue, simply press PF6. You will receive a message telling you how many authorized user 
IDs the EXEC has processed. Press PF3 again to return to the Primary Option Menu. 
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GRP121 SAVED SYSTEM INFORMATION FOR < > PAGE 1 OF 2 


To ADD, fill in the blanks with the information. 
To CHANGE, type the information over the displayed value. 
To DELETE, type blanks on the line. 


Pressing the ENTER key or PF6 key will save the update. 


SYSTEM DISK address (S-disk) . : 595 
SYSTEM DISK EXTENSION address (Y- disk): 59E 


USERID to RECEIVE STORAGE DUMPS. .. .: 
RECOVERY MACHINE USERID (required) . .: 


GCS TRACE TABLE SIZE (minimum 4K). . .: 16K 
PF; 1 HELP 2 CLEAR 3 END ee 5 REFRESH 6 SAVE 
Pred. was 8 NEXT 9 VERIFY 10 ... LT: 2a 12 CURSOR 
=sSS> 


10. To complete the first Saved System Information panel: 
a. Specify your disk addresses. 


The default 595 and 59E virtual addresses are already saved and verified. If you must choose 
different addresses, type over the default values. 


Note: Make sure the new information is correct; the GROUP EXEC does not prevent you from 
saving invalid information. 


b. Name an authorized dump receiver. 
Name an authorized recovery machine. 


GCS requires you to enter a recovery machine user ID. The GROUP EXEC tells you whether that 
user ID is valid, but it does not prevent you from saving an invalid entry. 


c. Specify a trace table size. 


By default, the GROUP EXEC saves a value of 16K. If you decide to save a different amount, 
simply type the new value over the default value. 


d. Save your input. 

If you are satisfied with your choices, press PF6 or ENTER to save the information. 

Warning: If you do not save the information before going on, the system will not accept it as input. 
e. Go to the second panel. 


Press PF8 to continue on the second Saved System Information panel. 
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GRP122 SAVED SYSTEM INFORMATION FOR < PAGE 2 OF 2 


To ADD, fill in the blanks with the information. 
To CHANGE, type the information over the displayed value. 
To DELETE, type blanks on the line. 


Pressing the ENTER key or PF6 key will save the update. 


MAXIMUM NUMBER of VIRTUAL MACHINES (required). .: 


SYSTEM ID (maximum 130 characters) ...... «3 


PF: 1 HELP 2 CLEAR 3 END ves 5 REFRESH 6 SAVE 
PF: 7 PREVIOUS 8 ... Di aca és eee 12 CURSOR 


11. To complete the second Saved System Information panel: 
a. Specify a MAXIMUM NUMBER. 


Simply type a value of | or more, and press ENTER. The GROUP EXEC responds with a message 
only if you enter an invalid value. 


b. Type in your SYSTEM ID text. 


This is optional. Move the cursor to the SYSTEM ID space (if it is not already there) and enter 
your text. The GROUP EXEC does not let you enter any more than 130 characters. 


c. Save your input and return to the Primary Option Menu. 


Press ENTER to save your information and then press PF3. 
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12. 


13. 


GRP13 AUTOMATIC SAVED SEGMENT LINKS FOR PAGE 1 OF 1 


To ADD, fill in the blanks with the saved segment names 
that will be linked automatically during 
initialization of this virtual machine group. 

To CHANGE, type a new saved segment name over the saved 
segment name to be changed. 

To DELETE, type blanks on the line. 


Pressing the ENTER key or PF6 key will save the update. 


PF: 1 HELP 2 CLEAR 3 END Te REFRESH 6 SAVE 
PF: 7 PREVIOUS 8 NEXT 9 VERIFY 10 ... any 12 CURSOR 


To complete the Automatic Saved Segment Links panel: 
Note: Do not include CMSVSAM and CMSBAM segments here. 
a. Type in the segment names. 


Press ENTER or PF6 after typing each segment nameto save your information and advance to the 
next space at the same time. Every time you press ENTER or PF6, the EXEC tells you how many 
segment names it has processed. Use PF7 and PF8 if you have more than one screen of names. 


b. Return to the Primary Option Menu. 


If you have not saved your input yet, press ENTER or PF6. Press PF3 to return to the Primary 
Option Menu. 


Once you have provided the necessary input on all panels and returned to the Primary Option Menu for 
the last time, press PF3 to exit from the GROUP EXEC. 


. Remove the temporary GCS message file from user storage and erase it on your A-disk: 


set language langid (delete csi user langid is your system default national language. If 
erase csiume[y] text a Mf you have not installed a different one, your default 
is ameng. 


. Spool punch output to your own virtual reader: 


spool punch * @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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16. Invoke the ITASK EXEC with the BUILD GCS parameters: 


itask build gcs systemname Wl systemname must match the name you specified 
when you issued the GROUP EXEC. If you do 
not specify a name, the default 1s GCS. 


HCPNSD440I The Named Saved System (NSS) systemname 
was successfully defined 
in fileid fileno 
OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nnnn NSS A onnnn mm/dd hh:mm:ss CMS NSS MAINT 
*NSS nnnn NSS A nnnn mm/dd hh:mm:ss CMSXA NSS MAINT 
*NSS nonnn NSS S_— nnnn mm/dd hh:mm:ss GCS NSS MAINT 


DMSUPD181E No update files were found 
DMSWHM19071I Assembling systemname 
DMSWHM1909I systemnome TEXT A created 
191 replaces A (191) 

5E5 replaces B (5E5) 


| If You Receive an Assembly Error | 


If you receive an assembly error, you may have to reestablish the minidisk access order: 


access 565 b Hf 
vmfsetup 56643089 gcs (all @ 
erase 56643089 $setup a @ 


Then go back and check your configuration file, which ITASK has renamed systemname ASSEMBLE. 
Refer to “Planning for the Group Control System (GCS)” on page 9 for information regarding required 
fields. Correct the file or go through the GROUP EXEC panels again to recreate the file. (If you 
recreate the configuration file, you must use the same systemname.) After you recreate the configuration 
file, rename or erase the old systemname ASSEMBLE file, then rename the new configuration file from 
GROUP to ASSEMBLE. Issue the ITASK BUILD GCS systemname command to assemble the 
configuration file and to build and save the nucleus. 


fee End of If You Receive an Assembly Error a 


Lid, 


PRT FILE fileno SENT FROM MAINT PRT AS fileno These are informational messages. You can 
RECS nnnn COPY 001 A NOHOLD NOKEEP ignore them. 
nnannnnn FILES CHANGED 


LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


RDR FILE fileno SENT FROM MAINT PUN AS fileno The GCS nucleus has been sent to MAINT’s 
RECS nnnn COPY 001 A NOHOLD NOKEEP virtual reader. 


Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be that a 
PTF now being applied has another PTF, outside 
GCS, as a prerequisite. Check the S3VMFBLD 
S$ERRLOG file for message DMSBNC1854W. 


Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build 
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18. 


20. 


21. 


Copy the text deck, configuration file. ASSEMBLE file, and EXEC from MAINT 191 to MAINT 495: 


access 495 d @ 

Ready; T=n.nn/n.nn hh:mm:ss 

copy systemname text a = = d (replace @ 
Ready; T=n.nn/n.nn hh:mm:ss 

erase systemname text a @ 

Ready; T=n.nn/n.nn hh:mm:ss 

copy systemname group a = = d (replace @ 
Ready; T=n.nn/n.nn hh:mm:ss 

erase systemname group a @ 

Ready; T=n.nn/n.nn hh:mm:ss 

copy systemname assemble a = = d (replace @ 
Ready; T=n.nn/n.nn hh:mm:ss 

erase systemname assemble a Hf 

Ready; T=n.nn/n.nn hh:mm:ss 


Verify that the GCS nucleus is in MAINT’s virtual reader: 


query rdr maint all Wf The ALL operand requests a display of all 
information about the reader files. 

ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT nonn * PUN nannnnnn 001 NONE mm/dd hh:mm:ss fn ft SYSPROG 


Ready; T=n.nn/n.nn hh:mm:ss 
This is the file that you will IPL in substep 22 on 
page 286. It has approximately 8,000 records. 
The exact size varies according to the system 
default language, local modifications, and VMSUP 
level. 


The name of the IPL deck is the same as the last 
entry in the GCS load list. If you have difficulty 
identifying the IPL deck and need to know the 
reader file number, refer to the last entry in the 
GCS load list systemname EXEC. (The default 
name is GCSLOAD EXEC). 


Order your reader so that the GCS nucleus will be processed first: 


order rdr fileno @ fileno is the file number of the GCS nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


Query the reader. If it is not class *, spool it as class *: 


query virtual c @ 
RDR OOOC CL cl NOCONT NOHOLD EOF READY 
000C nnnn CLOSED NOKEEP 
Ready; T=n.nn/n.nn hh:mm:ss 
spool c class * @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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22. Load (IPL) MAINT’s virtual reader: 


ipl] 86c clear @& 


MSG FROM MAINT : CSIINI1341 systemname has nnnnnn 
bytes of available common free storage 
HCPNSS440I Named Saved System (NSS) systemname 
was successfully saved in fileid fileno 


PRT FILE fileno SENT FROM MAINT PRT WAS fileno This message indicates that the GCS load map file 


RECS nnnn CPY Q01 NOHOLD NOKEEP has been sent to MAINT’s virtual printer. If you 
plan to save or print the GCS load map, record 
fileno. 

. IPL 190: 
ip] 190 @ 


DMSWSP327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 
| 


Ready; T=n.nn/n.nn hh:mm:ss 


Note: If necessary, purge your reader to free spool space. 


r Saving and Printing the GCS Load Map ~————~&' 


24. The GCS load map has been sent to MAINT’s virtual printer. To save the load map on disk, issue the 


following commands: 


query prt all 

OWNERID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT fileno A PRT nnnnnnnn 001 NONE mm/dd hh:mm:ss SYSPROG 

Ready; T=n.nn/n.nn hh:mm:ss The GCS load map is the file with a blank 
filename and filetype. It has approximately 2,200 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUP level. 


Note the fileno of this file. You will use it in your 
next command. 


#cp transfer prt fileno to * rdr @ 
access 495 d @ 
receive fileno fn ft d @ 


You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as 1 —9, A, B, ©), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 
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Once you have the load map saved on disk, you can print a copy of it by issuing the following command: 


print fn ft d B 


Leen End of Saving and Printing the GCS Load Map ee are ee 


| Installing Multiple GCS Systems | 


25. You can install more than one GCS system, if you defined the additional systems in the system directory. 
To install each additional system: 
a. Reestablish the minidisk access order: 
access 5E5 b &@ 


vmfsetup 56643089 gcs (ail 
erase 56643089 $setup a 


b. Set up the GROUP EXEC messages in storage (full-screen display devices only): 


copyfile csimes[y]| [text|txtnnnnn] fm csiume[y]text a @ 


The CSIMES text file is shipped as TXTnannnn. The most current version of this file can be 
determined by referring to the first entry in the CSIMES AUX file. In the first entry, there 1s a field 
which reads UMnnnnn, where nnnnn is the PTF number. 


Note: If you have not received service on the CSIMES text file, you do not have a CSIMES file 
with a filetype of TXTnnnnn. You will have one with a filetype of TEXT. 


copyfile csimes[y]| text fm csiume[y] text a 
Ready; T=n.nn/n.nn hh:mm:ss 


set language langid (add csi user @ 


c. Create a configuration file for each nucleus. 
e If you are using a full-screen display device, issue: 
group systemname @& systemname is a unique filename. Then 


complete the GCS panels to define the system 
parameters. 


e If you are not using a full-screen display device, refer to the VM/XA SP Group Control System 
Command and Macro Reference. Use the build macros to create the configuration file. 


d. Remove the temporary GCS message file from user storage and erase it from your A-disk (full-screen 
display devices only): 


set language langid (delete csi user B 
erase csiume[y| text a @ 
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e. For each new GCS system, add a DEFSYS statement to the SAMPNSS EXEC. For information on 
the DEFSYS command, see the VM/XA SP CP Command Reference. 


f. For each new GCS system, add an override section at the end of the product parameter file. This 
example shows an override section for a GCS system called NEWGCS: 


sNEWGCS. GCS 

:BLD. REPLACE 

NEWGCS VMFBDNUC BUILD1 
> END. 


You must also add the name of the new GCS system to the :OVERLST. tag at the top of the 
product parameter file, for example: 


sOVERLST. CORCP CORCMS CORGCS NEWGCS 


g. For each GCS system, assemble the configuration file, build and save the new GCS nucleus, and 
copy the text deck, configuration file, ASSEMBLE file, and EXEC to the 495 disk: 


access 565 b 
vmfsetup 56643089 gcs (all @ 
erase 56643089 $setup a @ 


itask build gcs systemname @ 
access 495 d @ 

copy systemname text a = = 
erase systemname text a 
copy systemname group a = = d (replace Mf 
erase systemname group a @ 

copy systemname assemble a = = d (replace @ 
erase systemname assemble a @ 

ip! 00c clear Hf 

ip] cms # 


d (replace Mf 


Before you build another GCS nucleus, save or print the GCS load map, as indicated above. 
Remember to give each load map file a different name. 


eee End of Installing Multiple GCS Systems ee 
26. Verify that all your GCS segments were defined correctly: 


query nss all 

OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS = fileno NSS R_=nnnn mm/dd hh:mm:ss GCS NSS MAINT 
*NSS — fileno NSS) R_=nnnn mn/dd hh:mm:ss systemname NSS MAINT 


27. When you complete your GCS installation, go to “Step 29. Save CMS” on page 289. 
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Step 29. Save CMS 


In this step, you will save CMS as a named saved system, in both 370 mode and 370-XA mode, at default 
addresses. 


This step takes approximately 10 minutes. 


Note: For general information about CMS as a named saved system, see VM/XA SP Planning and 
Administration. 


1. Make sure: 
e You are logged on as MAINT. 


¢ You have finished loading all files to the 190 and 19E minidisks. After this step, any change to files 
on these disks requires resaving CMS. 


e You have 16 megabytes of virtual storage. To determine your storage size, issue QUERY 
VIRTUAL STORAGE. If you have less than 16 megabytes, issue DEFINE STORAGE 16M. 


e CMS is running. If not, load CMS by issuing IPL 190 CLEAR. Wait for the CMS version 
identification to appear on the screen. Then press ENTER. 


2. Invoke the SAMPNSS EXEC: 


sampnss cms cmsxa The SAMPNSS EXEC issues the DEFSYS 
command. 


Note: If you use “CMS” (the default name) for 
the System/370 name, users will receive the 
new level of CMS whenever they issue the 
command IPL CMS. 


HCPNSD440I Named Saved System (NSS) CMS was The SAMPNSS EXEC first issues the DEFSYS 
successfully defined in fileid command to define a skeleton system data file for 
fileno CMS and for CMSXA. These messages tell you 


the DEFSYS commands were successful. 
HCPNSD440I Named Saved System (NSS) CMSXA was 
successfully defined in fileid 
fileno 


The names shown in the SAMPNSS command are 
the default names for the System/370 (CMS) and 
for the 370-XA (CMSXA) systems. Of course, 
you may name these systems whatever you wish; 
but if you change the names you must either edit 
the SAMPNSS EXEC to use your names or define 
your systems manually. 


Note: The names are positional on the command 
(the System/370 name followed by the 
370-XA name). 
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OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) S— nnnn mm/dd hh:mm CMS 
*NSS nnnn NSS) S_— nonn mn/dd hh:mm CMSXA 


Ready; T=n.nn/n.nn hh:mm:ss 


NSS MAINT 
NSS MAINT 


The SAMPNSS EXEC issues a QUERY NSS 
command. These messages show what system 
data files are defined. 


3. Issue the QUERY NSS ALL MAP command to make sure CMS is defined properly. Check whether the 
information under BEGPAG, ENDPAG, TYPE, and CL in the response to QUERY NSS ALL MAP is 


the same as shown. 


query nss all map @ 
FILE FILENAME FILETYPE MINSIZE BEGPAG 


nnnn CMS NSS 000256K 00000 
00020 
QQEOO 
nnonn CMSXA NSS 000256K 00000 
00020 
QOEDO 
Ready; T=n.nn/n.nn hh:mm:ss 


ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


G000A 
90022 
OOF FF 
QQ00A 
00022 
OOFFF 


EW 
EW 
SR 
EW 
EW 
SR 


S 00000 OMITTED NO 


S 00000 OMITTED NO 


4. Set your machine mode to 370, load CMS (IPL 190), and save the CMS system: 


set machine 370 
SYSTEM RESET 
SYSTEM = 370 


ip! 190 clear parm savesys cms @ 


HCPNSD440I Named Saved System (NSS) CMS was 
successfully saved in fileid fileno 


DMSWSP327I The installation saved segment 


could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm 


es 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


If your machine is already in 370 mode, you will 
not get a response. 


Load 190 with the option to save the system under 
the name CMS. 


Disregard the message about not loading the saved 
segment; CMS has been successfully saved as a 
named saved system. 


If you have changed the version heading, your 
own heading will appear. 


Press ENTER to initialize CMS. 


5. Set your machine mode to XA, load CMS (IPL 190), and save the CMSXA system: 


set machine xa & 
SYSTEM RESET 
SYSTEM = XA 


ip] 190 clear parm savesys cmsxa @ 


HCPNSD440I Named Saved System (NSS) CMSXA was 


successfully saved in fileid fileno 
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If your machine is already in 370-XA mode, you 
will not get a response. 


Load 190 with the option to save the system under 
the name CMSXA. 


DMSWSP3271 The installation saved segment Disregard the message about not loading the saved 


could not be loaded segment; CMSXA has been successfully saved as a 
VM/XA CMS 5.6 mm/dd/yy hh:mmn named saved system. 
a Press ENTER to initialize CMS. 


SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 


. Set your machine mode to 370 (or XA), redefine your virtual storage to 2 megabytes, and load the CMS 
(or CMSXA) named saved system. The example below shows loading CMS in System/370 mode: 


set machine 370 & If your machine is already in 370 mode, you will 
SYSTEM RESET not get a response. 

SYSTEM = 370 

define storage 2m @ 


STORAGE = 2M Defining storage causes a system reset. 
Storage cleared - system reset 

ip] cms # 

DMSINS327I The installation saved segment could not be loaded 

VM/XA CMS 5.6 mm/dd/yy hh:mm 


a After receiving the CMS version identification, 
SYNONYM SYN press ENTER to complete CMS or CMSXA 
CP TERM MODE VM initialization. 


Ready; T=n.nn/n.nn hh:mm:ss 


. Check the CMS status by issuing QUERY NSS ALL and QUERY NSS ALL MAP. Check whether the 
information under FILENAME and FILETYPE in the response to QUERY NSS ALL is the same as 
shown. Also, check whether the information under BEGPAG, ENDPAG, TYPE, and CL in the 
response to QUERY NSS ALL MAP is the same as shown. The system data file should now have class 
A (rather than S) and have one user (MAINT). 


query nss all @ 
OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS A_nnnn mn/dd hh:mm:ss CMS NSS MAINT 
*NSS nonn NSS A_nnnn mm/dd hh:mm:ss CMSXA NSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


query nss all map 
FILE FILENAME FILETYPE MINSIZE BEGPAG ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


nonn CMS NSS Q000256K 00000 OO0GA EW A 00001 OMITTED NO 
00020 00022 EW 
QOOEOO OOFFF SR 

nnonn CMSXA NSS 000256K 00000 OOO0A EW A QQ000 OMITTED NO 
00020 00022 #£4€EW 
QOEQO OOFFF SR 

Ready; T=n.nn/n.nn hh:mm:ss 
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8. Redefine your storage before you continue with the following steps: 


define storage l6m & 

STORAGE = 16M 

Storage cleared - system reset 

ip! 198 clear @ 

DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

a 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 
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Step 30. Install the CMSDOS, CMSBAM, CMSVSAM, and CMSAMS 
Saved Segments 


If you plan to use the CMS/DOS environment or the VSAM product, you must install the CMSDOS, 
CMSBAM, CMSVSAM, and CMSAMS saved segments. 


If you do not want to install these saved segments, go to “Step 31. Create the CMSINST and HELP 
Saved Segments” on page 301. 


In this step, you will: 


¢ Install CMSDOS and CMSBAM in separate saved segments 
e Create a CMSVSAM segment and install the VSAM product tape 
e Create a CMSAMS segment and install Access Method Services. 


This step takes approximately | hour. 


Warning: The CMSDOS and CMSBAM segments must be installed before you install CMSVSAM and 
CMSAMS. 


Note: For more information about saved segments, see VM/XA SP Guide to Saved Segments. 


1. IPL 190. This is the CMS system disk. 


define storage l6m @ 

STORAGE = 0016M 

STORAGE CLEARED - SYSTEM RESET 

ip! 190 clear @ 

DMSINS327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm Your own installation header appears if you have 


changed it. 
** DO NOT press ENTER! ** een 


access (noprof Mf This command suppresses execution of MAINT’s 
PROFILE EXEC. 

Ready; T=n.nn/n.nn hh:mm:ss Access the disks with installation and service 

access 193 e i EXECs, and the DOSGEN EXECs. 


access 5E5 b Mf 
Ready; T=n.nn/n.nn hh:mm:ss 


set emsg on @ You want to see any and all error messages during 
Ready; T=n.nn/n.nn hh:mm:ss execution of the installation EXEC. 


2. Define a segment into which the DOSGEN EXEC can load CMSDOS: 
defseg dosinst 900-90f sr Ml This command defines a 1M segment for 
HCPNSD440I Saved segment DOSINST was DOSINST starting at 900000. You may place this 
successfully defined in fileid segment anywhere below the segment spaces 
fileno defined for CMSDOS, CMSBAM, CMSVSAM, 
Ready; T=n.nn/n.nn hh:mm:ss and CMSAMS. 
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3. Invoke the DOSGEN EXEC with a load address and the name DOSINST. The load address used for 
DOSINST in this example 1s 900000. 


dosgen 900000 dosinst Mf The load address and name are those 

HCPNSS440I Saved segment DOSINST was recommended for the DOSINST segment. Error 
successfully saved in fileid messages for the DOSGEN EXEC are listed on 
fileno page 295. 


PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 

DMSWGN715I DOSGEN COMPLETE 

Ready; T=n.nn/n.nn hh:mm:ss 


4. IPL CMS: 


ip] cms & 
DMSINS327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm 
a 


SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nan hh:mm:ss 


5. Define CMSDOS, CMSBAM, CMSAMS, and CMSVSAM: 


set sysname cmsdos dosinst 
Ready; T=n.nn/n.nn hh:mm:ss 
sampnss cmsdes @ 


HCPNSD440I Saved segment CMSDOS was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS A nnnn mm/dd hh:mm:ss DOSINST ODCSS MAINT 
*NSS nonn NSS S— nnnn mm/dd hh:mm:ss DOSBAM — DCSS MAINT 
*NSS nonn NSS) S— nnnn mm/dd hh:mm:ss CMSDOS — DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


Sampnss cmsbam @ 
HCPNSD440I Saved segment CMSBAM was successfully 
defined in fileid fileno 


OQWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) S— nnann mm/dd hh:mm:ss CMSBAM — DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


sampnss cmsams @ 
HCPNSD440I Saved segment CMSAMS was successfully 
defined in fileid fileno 
OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) S—onnnn mm/dd hh:mm:ss CMSAMS — DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
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sampnss cmsvsam 
HCPNSD440I Saved segment CMSVSAM was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS noinn NSS) S— nann mm/dd hh:mm:ss CMSVSAM DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


. Invoke the DOSGEN EXEC with a load address and the name CMSDOS. The load address set up by 


SAMPNSS is B00000 for the name CMSDOS. 


access 1933 e @ The load address and name are those 
Ready; T=n.nn/n.nn hh:mm:ss recommended for the CMSDOS segment. Error 
dosgen b00000 cmsdos @ messages for the DOSGEN EXEC are listed on 


HCPNSS440I Saved segment CMSDOS was successfully page 295. 
saved in fileid fileno 
PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 
DMSGEN715I DOSGEN COMPLETE 
Ready; T=n.nn/n.nn hh:mm:ss 


. To save the load map, rename it and copy it to the alternate LOCAL minidisk (395): 


access 395 d Hf 

DMSACC724I 395 replaces D(395) 
Ready; T=n.nn/n.nn hh:mm:ss 

copy load map a cmsdos segmap d @ 
Ready; T=n.nn/n.nn hh:mm:ss 


Error Messages from DOSGEN 
If DOSGEN detects an error in the address that you specified: 
DMSGENO95E INVALID ADDRESS 
If DOSGEN cannot find a read/write accessed A-disk: 
DMSGENOQ6E NO READ/WRITE A-DISK ACCESSED 
If DOSGEN finds unresolved external references while loading the text files: 
DMSGEN111E£ DOSGEN FAILED DUE TO LOAD ERRORS 
If DOSGEN detects an error while assigning the storage key or saving the segment: 
DMSGEN412S DOSGEN FAILED DUE TO SETKEY ERRORS 


DMSGEN141S DOSGEN FAILED DUE TO SAVESYS ERRORS 
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8. Replace the name CMSBAM in the CMS SYSNAME table with any name that is not a name previously 
used as a segment name: 


set sysname cmsbam sysname Wl The SET SYSNAME command enters an 

Ready; T=n.nn/n.nn hh:mm:ss alternate name for CMSBAM in the SYSNAME 
table. Choose a name that was not used 
previously as a segment name. This command 
does not actually change the saved segment’s 
name, but keeps CP from finding and IPLing the 
segment at the wrong time. 


9. Place your CMS virtual machine in a CMS/DOS environment, then invoke SAMGEN to load the 
CMSBAM segment. You must give the EXEC an address at which to load the CMSBAM segment: this 
address also must match the address in the skeleton CMSBAM segment that you defined beforehand. 


set dos on This command places your virtual machine in a 
CMS/DOS environment. 


DMSSET400I SYSTEM sysname DOES NOT EXIST You may receive these informational messages. 
DMSSET1101I 100K DOS partition defined sysname 1s the name you chose in substep 8. 
at hexadecimal location 020000. 
Ready; T=n.nn/n.nn hh:mm:ss 
samgen @ 
DMSSGN363R ENTER LOCATION WHERE CMSBAM 
WILL BE LOADED AND SAVED: 


b10000 

DMSSGN364I FETCHING CMSBAM... 

DMSFET7101 Phase DMSVBM entry point at location B100CO. 
DMSSGN366R ENTER NAME OF SYSTEM TO BE SAVED: 

cmsbam Mf 


HCPNSS440I Saved segment CMSBAM was successfully The messages indicate that the segment has been 
saved in fileid fileno loaded and saved. 

DMSSGN365I SYSTEM CMSBAM SAVED 

Ready; T=n.nn/n.nn hh:mm:ss 


10. Set DOS off: 


set dos off @ 
Ready; T=n.nn/n.nn hh:mm:ss 


11. Define and format a minidisk for VSAM files. 


a. Map your USER DIRECT and examine the map to find a space for the new minidisk. Look fora 
gap of appropriate size and record the starting cylinder of that gap. The number of cylinders needed 
depends on the DASD type: 


Device Cylinders Needed 


3350 15 cylinders 
3375 22 cylinders 
3380 14 cylinders 
3390 14 cylinders 
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access 295 d @ Refer to the directory map to find a gap. 


Ready; T=n.nn/n.nn hh:mm:ss Repeat the locate command as many times as 
diskmap user direct necessary. When you find a suitable gap, note 
File USER DISKMAP A has been created. the starting cylinder and DASD label the 
Ready; T=n.nn/n.nn hh:mm:ss cylinders reside on and leave the file. 


xedit user diskmap 
locate/GAP 

qquit Hf 

Ready; T=n.nn/n.nn hh:mm:ss 


. XEDIT your directory and add an entry for the new minidisk: 


xedit user direct 


locate/USER MAINT Locate the MAINT minidisk definitions. 
locate/MDISK @ 
input # 


MDISK vdevno devtype startcyl cyls label MW ALL @ 


vdevno, devtype, and label are the address, device 
type, and label of the DASD volume where the 
new minidisk is located. startcyl is the starting 
cylinder of the gap where the new minidisk is 
defined. cy/s is the number of cylinders needed 
for the minidisk. 


a Press ENTER to return to the command line. 
file Hf 


. Map the directory again and examine the map to make sure that the new minidisk was created in the 
place you specified and that it does not overlap any existing minidisks: 


diskmap user direct @ 


. Issue DIRECTXA to update the directory and bring it online: 


directxa user Hf 

VM/XA SYSTEM PRODUCT USER DIRECTORY CREATION PROGRAM - RELEASE 2.1 
EQJ DIRECTORY UPDATED AND ONLINE 

Ready; T=n.nn/n.nn hh:mm:ss 


. Link to the new minidisk: 


link * vdevno vdevno 
Ready; T=n.nn/n.nn hh:mm:ss 
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f. Format the new minidisk: 


format vdevno v (blksize 2048 @ 

DMSFOR603R FORMAT will erase all the files on disk V(vdevno). 
Do you wish to continue? 
Enter 1 (YES) or © (NO). 

1 

DMSFOR605R Enter disk label: 

label @ 

DMSFOR7331I Formatting disk V 

DMSFOR732I nn cylinders formatted on V(vdevno) 

Ready; T=n.nn/n.nn hh:mm:ss 


g. Access the new minidisk as A: 


access vdevno a 
Ready; T=n.nn/n.nn hh:mm:ss 


12. Set DOS on: 


set dos on You may receive these informational messages. 
DMSSET400I SYSTEM sysname DOES NOT EXIST sysname is the name you chose in substep 8 on 
DMSSET11011 100K DOS partition defined page 296. 


at hexadecimal location 020000. 
Ready; T=n.nn/n.nn hh:mm:ss 


13. Mount the VSAM product tape on a tape drive attached to MAINT at virtual address 181. (If you do 
not have the proper class authority to attach a tape, the system operator may have to do it for you.) 


14. Invoke VSAMGEN EXEC: 


vsamgen 
SELECT ONE OF THE FOLLOWING FUNCTIONS BY ENTERING THE NUMBER: 


1. INSTALL AMS (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
2. INSTALL VSAM (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
3. INSTALL VSAM AND AMS (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
4. BUILD AMS (BUILD DOSLIB, CREATE SEGMENT) 

5. BUILD VSAM (BUILD DOSLIB, CREATE SEGMENT) 

6. BUILD VSAM AND AMS (BUILD DOSLIB, CREATE SEGMENT) 

7. RESTART AMS (CREATE SEGMENT) 

8. RESTART VSAM (CREATE SEGMENT) 

9. RESTART VSAM AND AMS (CREATE SEGMENT) 

10. QUIT (EXIT VSAMGEN EXECUTION) 


ENTER RESPONSE... 


Choosing option 3 tells the EXEC to create both CMSVSAM and CMSAMS segments as new segments. 
If this is the initial installation of VSAM, select function 1, 2, or 3. 


If the text files have already been created from the VSAM product tape and are currently on the accessed 
A-disk, select function 4, 5, or 6. 


If the DOSLIBs currently reside on an accessed disk, select function 7, 8, or 9. In this case, it is not 
necessary to have the text files available. 
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3 


DMSVGN365R ONE OR MORE OF THE TEXT FILES LISTED IN THE BOTH EXEC 
ARE MISSING. THE VSAM PP PID TAPE SHOULD BE ON TAPE DRIVE 181 
TO RESTORE THE FILES. ENTER: 
'GO' IF TAPE DRIVE IS READY TO LOAD FILES, 
‘QUIT’ TO STOP GENERATION PROCESS. 
go 


Messages from VSAMGEN 


While VSAMGEN Is processing, you may receive error and information messages. These messages 
are self-explanatory. Messages labeled 21011 are information messages from the linkage editor and 
may be ignored. 


Respond to the EXEC messages as they appear: 


DMSVGN3621I LINK-EDITING CMSVSAM ... 
DMSVGN363I CMSVSAM DOSLIB CREATED ON DISK 'A'. 
DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER 'QUIT'. 
go 
DMSVGN363R ENTER LOCATION WHERE CMSVSAM SHARED WILL BE 
LOADED AND SAVED: 


ba0000 & 


DMSVGN363R ENTER LOCATION WHERE CMSVSAM NONSHARED WILL BE 
LOADED AND SAVED: 
a30000 


DMSVGN3641 FETCHING CMSVSAM ... 

DMSFET710I PHASE DMSVVS ENTRY POINT AT LOCATION nnnnnn 

DSMVGN371R CMSVSAM IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
‘'CP' MODE, APPLY THE ZAPS AND THEN REPLY 'GO' 

go 

DMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


cmsvsam & This name is the default name with which the 
segment was defined. 


DMSVGN365I SYSTEM CMSVSAM SAVED. 


DMSVGN368R ERASE CMSVSAM DOSLIB ? ... ENTER 'YES' OR 'NO': 
no @ 


DMSVGN362I LINK-EDITING CMSAMS ... 
DMSVGN363I CMSAMS DOSLIB CREATED ON DISK ‘A’. 
DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER 'QUIT'. 
go @ 
DMSVGN363R ENTER LOCATION WHERE CMSAMS SHARED WILL BE 
LOADED AND SAVED: 
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b40000 This is the recommended location. 
DMSVGN363R ENTER LOCATION WHERE CMSAMS NONSHARED WILL BE 
LOADED AND SAVED: 

a00000 

DMSVGN364I FETCHING CMSAMS ... 

DMSFET710I PHASE DMSVAS ENTRY POINT AT LOCATION nnnnnn 

DMSFET710I PHASE DMSVAN ENTRY POINT AT LOCATION nnnnnn 

DMSFET7101 PHASE DMSVAX ENTRY POINT AT LOCATION nannnn 

DMSVGN371R CMSAMS IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
'CP' MODE, APPLY THE ZAPS AND THEN REPLY 'GOQ' 

go 

DMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


cmsams @ This name is the default name used for defining 
the segment. 


DMSVGN365I SYSTEM CMSAMS SAVED. 


DMSVGN368R ERASE CMSAMS DOSLIB ? ... ENTER 'YES' OR 'NO': 
no @ 


Ready; T=n.nn/n.nn hh:mm:ss 


15. You may now purge the DOSINST named saved segment: 


query nss all @ 
OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nnnn NSS A_nnnn mm/dd hh:mm:ss DOSINST DCSS MAINT 


Ready; T=n.nn/n.nn hh:mm:ss 


purge nss fileno i fileno is the file identifier for DOSINST. 
No files purged 

0001 file pending purged 

Ready; T=n.nn/n.nn hh:mm:ss 

set dos off @ 


Ready; T=n.nn/n.nn hh:mm:ss 
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Step 31. Create the CMSINST and HELP Saved Segments 


In this step. you will: 


e Define a segment to contain EXECs and System Product Editor macro instructions 
e Use the DCSSGEN command to load and save the CMSINST segment 
e Save the HELP file directory in a saved segment. 


Notes: 


1. You must have the NAMESAVE HELP statement in your user directory in order to save the 
HELP file directory information in a saved segment. 


See “Step 21. Update the User Directory” on page 71. 


NW 


. If the HELP segment is defined as a member of a segment space, you must have a NAMESAVE 
statement (for example, NAMESAVE INSTHELP) in the directory entry for the user who 
invokes SAVEFD. SAVEFD specifies the name of the segment space. 


This step takes approximately 20 minutes. 


Note: For more information about saved segments, see VM/XA SP Guide to Saved Segments. 


|. Log on as MAINT (unless you are continuing from the previous step). 


2. Check your virtual storage. If it is less than 16M, issue the following: 


define storage l6m Hf 
STORAGE CLEARED - SYSTEM RESET 
STORAGE = 0016M 


3. IPL CMS: 


ip] cms @ 
DMSWSP3271 The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm If you have changed the version heading, your 
own heading will appear. 


i Press ENTER to complete the CMS initialization. 
SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


4. Use the SAMPNSS EXEC to define a segment for CMSINST: 


Note: If you have increased the number of entries in the CMS load list, be sure that the DEFSEG entry 
for CMSINST in the SAMPNSS EXEC has enough pages defined to accomodate the increased 
SIZe. 


Sampnss cmsinst # 
HCPNSD4401 Saved segment CMSINST was successfully 
defined in fileid fileno 
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OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nnnn NSS S— nnonn mm:dd hh:mm INSTHELP DCSS MAINT 
*NSS nonn NSS S— nnnn mm:dd hh:mm CMSINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


The EXEC issues a QUERY command that 
displays information about the segments defined 
for named saved systems. 


5. Define the HELP segment: 


sampnss help @ 
HCPNSD440I Saved segment HELP was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS S— nnnn mn:dd hh:mm INSTHELP DCSS MAINT 
*NSS nonnn NSS §— nnnn mm:dd hh:mm CMSINST DCSS MAINT 


*NSS noann NSS) §S— nnnn mm:dd hh:mm HELP DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Save both segments: 


saveseg cmsinst Ml Each member saved segment defined by 
HCPNSS440I Saved segment CMSINST was SAMPNSS must be saved separately. 
successfully saved in fileid 
fileno 


Ready; T=n.nn/n.nn hh:mm:ss 

saveseg help Hf 

HCPNSS440I Saved segment HELP was 
successfully saved in fileid 
fileno 

Ready; T=n.nn/n.nn hh:mm:ss 


7. Redefine each segment to create the skeleton segments: 
Sampnss cmsinst & 
HCPNSD440I Saved segment CMSINST was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) S—onnnn mn:dd hh:mm CMSINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
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sSampnss help @ 
HCPNSD440I Saved segment HELP was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS 
*NSS nonn NSS S_— nnnn mm:dd hh:mm HELP 
Ready; T=n.nn/n.nn hh:mm:ss 


nnnn NSS S— nnann mm:dd hh:mm CMSINST DCSS 
DCSS 


MAINT 
MAINT 


. If you do not want to use the sample load list, CMSINST EXECLIST, for the DCSSGEN command, use 


the System Product Editor (XEDIT) to create your own load list: 


xedit instlist file a Hf 
input @ 


* Rename RDRLIST EXEC to MAIL EXEC 
RDRLIST EXEC * MAIL = 

FILELIST EXEC S 

SYSPROF EXEC S 

PARSE XEDIT S$ 

DISCARD EXEC S$ 

NOTE EXEC S 

PROFNOTE XEDIT S 

ALL XEDIT S @& 


1 
file @ 


This is a sample. Enter the load list entries you 
need. 


Only one comment line per list is allowed; it must 
be the first line. For more information on 
creating this list, see “DCSSGEN Command” on 
page 580. 


The remainder of the lines contain entries for 
frequently used EXECs and Editor macros; 
multiple users can share the same executing copy 
of these EXECs and macros. 


Press ENTER to return to the command line. 


. The load list must have a fixed record length in order for you to use the DCSSGEN command. If your 


load list has variable length records, change it to a fixed length file by issuing: 


copyfile fn ft fm = = = (recfm f Irecl 80 replace @ 


. Invoke the DCSSGEN command: 


access 193 e @ 
dcssgen fn ft fm cmsinst Ml 


Jn ft fm is the fileid of the file that contains the list 
of EXECs and Editor macros to be loaded into 
the segment, either CMSINST EXECLIST fm or 
your own file (for example, INSTLIST FILE A). 


CMSINST is the name of the segment you want 
to create. It is also the default name of the 
installation saved segment in the DMSNGP 
profile. If you changed the name in the 
DMSNGP profile, or specified a different name in 
response to the installation questions (see page 
248), use that name instead. If you do not specify 
a segment name, the DCSSGEN command 
defaults to CMSINST. 
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HCPNSS4401 Saved segment CMSINST was successfully 
saved in fileid fileno 
Ready; T=n.nn/n.nn hh:mmiss 


The DCSSGEN command creates a load map file, CMSINST DCSSMAP A. For the sample load list 
created in substep 8 on page 303, the load map would look like this: 


* RENAME RDRLIST EXEC TO MAIL EXEC 

RDRLIST EXEC * MAIL = 
15:41:59 10/22/85 copy of RDRLIST EXEC S loaded as MAIL EXEC 
EXISBLK - 280000 FBLOCK - 280100 LENGTH - 001C40 

FILELIST EXEC S$ 
15:41:58 10/22/85 copy of FILELIST EXEC S loaded as FILELIST EXEC 
EXISBLK - 280020 FBLOCK - 281D40 LENGTH - 0018C8 

SYSPROF EXEC S$ 
7:30:18 11/26/85 copy of SYSPROF EXEC S loaded as SYSPROF EXEC 
EXISBLK - 280040 FBLOCK - 283608 LENGTH - 002178 

PARSE XEDIT S 
8:47:55 12/18/84 copy of PARSE XEDIT S loaded as PARSE  XEDIT 
EXISBLK - 280060 FBLOCK - 285780 LENGTH - 0024A0 

DISCARD EXEC $ 
15:40:32 10/22/85 copy of DISCARD EXEC S loaded as DISCARD EXEC 
EXISBLK - 280080 FBLOCK - 287C20 LENGTH - 0012B0 

NOTE EXEC $ 
11:03:53 10/24/85 copy of NOTE EXEC S loaded as NOTE EXEC 
EXISBLK - 2800AQ FBLOCK - 288ED0 LENGTH - 005310 

PROFNOTE XEDIT S 
15:41:55 10/22/85 copy of PROFNOTE XEDIT S$ loaded as PROFNOTE XEDIT 
EXISBLK - 2800CQ0 BLOCK - 28E1E0 LENGTH - 000980 

ALL XEDIT S 
15:41:05 10/22/85 copy of ALL XEDIT  S loaded as ALL XEDIT 
EXISBLK - 2800E0 FBLOCK - 28EB60 LENGTH - 001298 
*** End of Source List *** 
CMSINST built at 15:56:34 on 12/02/85 


Note: When you built your CMS nucleus, if you indicated in the DMSNGP file (USEINST = YES) or in 
answer to the DMSINQ296R prompt that you wanted to use the installation segment (the default 
is YES), then this segment is used each time a user IPLs CMS. If you previously indicated that 
you did not want to use the installation segment but now want to use it, you must modify the 
DMSNGFP file to indicate that the segment should be used, then assemble the modified DMSNGP 
and rebuild CMS. (To find the latest version of the DMSNGP file, issue SETUP to access all the 
minidisks where it might be; then issue FILELIST DMSNGP ASSEMBLE *. All the copies of 
DMSNGP ASSEMBLE will be listed, with the date when each one was last modified.) 
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Messages from DCSSGEN 


While DCSSGEN is processing, you may receive error or warning messages that indicate specific 
conditions. If errors were encountered, after processing is complete you receive the following prompt: 


DMSEXG298R An error has been detected while building the DCSS. 
Do you still want the DCSS saved? 
Enter 1 (YES) or © (NO). 


Enter | to disregard the error(s) and save the segment, or enter 0 to not save the segment. If you do 
not save the segment, you receive the message: 


DMSEXG288I segname not saved 
If DCSSGEN encounters an error while saving the segment, you receive the message: 
DMSEXG288E dcssname not saved 


If your virtual machine is not large enough to contain the segment (you need 16M), you receive the 
message: 


DMSEXG284E The DCSS is not completely inside the virtual machine 


To correct this situation, increase the size of your virtual machine, re-IPL CMS, and reissue the 
DCSSGEN command. 


11. Define your virtual storage less than the address at which the HELP segment ts to be loaded. For 
example, if the HELP segment is defined at X'C50000' (the default address in the SAMPNSS EXEC) 
define your storage as 12M. 


define storage 12m @ 
STORAGE CLEARED - SYSTEM RESET 
STORAGE = 12M 


12. Re-IPL CMS: 


ip] cms 

DMSWSP327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

a 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


13. Issue the following commands to initialize and save the segment: 


(For more information about using the SAVEFD command to save minidisk file directory information in 
a saved segment, refer to VM/XA SP CMS Command Reference.) 


savefd init vaddr label help @ vaddr is 19D for mixed-case American English, 
Ready; T=n.nn/n.nn hh:mm:ss 19C for uppercase American English. 


savefd save vaddr label help @ ; 
label is the CMS label assigned to the disk. (The 


DMSACP7 19D 
231 Z(19D) R/0 labels in the sample directory are MNT19D and 
HCPNSS440I Saved segment HELP was successfully MNTI9C.) 


saved in fileid fileno 
Ready; T=n.nn/n.nn hh:mm:ss 


Chapter 4. Installing VM/XA SP Using an Existing System 305 


14. 


15. 
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Verify that the CMSINST and CMSHELP segments were defined correctly: 


query nss all @ 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS —s fileno NSS A= nnnn mm/dd hh:mm:ss INSTHELP NSS MAINT 


*NSS fileno NSS A= nnnn mm/dd hh:mm:ss CMSINST NSS MAINT 
*NSS — fileno NSS A nnnn mm/dd hh:mm:ss HELP NSS MAINT 


The system data file should now have class A (rather than S) and have one user (MAINT). 


Redefine your storage before you continue: 


define storage l6m @ 

STORAGE = 16M 

Storage cleared - system reset 
ipl cms @ 

VM/XA CMS 5.6 mm/dd/yy hh:mm 
& 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 
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Step 32. Back Up the Named Saved System Files 


In this step, you will back up all the named saved systems, including CMS, on tape. 


This step takes approximately 10 minutes. 


1. Mount a scratch tape with ring on an available 3420, 3422, or 3430 tape drive, or insert a cartridge with 
the tab protector set to off in an available 3480 tape unit. Follow machine operations manuals to mount 


the tape. 
e Do not attach the tape unit to MAINT. 


e The tape must be suitable for a 3420, 3422, 3430, or 3480 tape unit. 


Issue the SPTAPE command to dump the CMS system data file to tape: 


sptape dump vdevno nss all run @ 


DUMPING vdevno NSS *NSS nnonn A 


SPTAPE DUMP FUNCTION ON DRIVE vdevno 
COMPLETE 
Ready; T=n.nn/n.nn hh:mm:ss 


Substitute the virtual device number of the tape 
drive for the value vdevno. The operand RUN 
specifies that the SPTAPE rewinds and unloads 
the tape after the operation. 


The messages from SPTAPE tell you that the file 
is being dumped to tape. The CMS ready message 
may occur between the messages. 


. Store the tape for emergency use. If it is ever necessary, you can use this tape and the SPTAPE 


command to restore the CMS system data file. For more information about the SPTAPE command, see 


VM/XA SP Real System Operation. 


To restore your CMS named saved system: 


l. 
2. 
3. 


Log on as MAINT. 
Mount the backup tape on a tape drive. 


Issue: 


sptape load vdevno nss all run @ 
LOADING vdevno NSS *NSS nnnn A NOW nnnn 


LOADING vdevno NSS *NSS nnnn A NOW nnnn 
SPTAPE LOAD FUNCTION ON DRIVE vdevno COMPLETE 


. IPL CMS: 


ipl cms @ 
VM/XA CMS 5.6 mm/dd/yy hh:mm 
i 


SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 33. Store a Backup Copy of CP on Tape 


In this step, you will use DDRXA to store a backup copy of CP on tape. 


The time to perform this step varies based on the device and contention for the device’s channel. It may 
take up to 30 minutes. 


1. Mount a scratch tape (with ring) on a tape drive. Follow machine operations manuals to mount the 
tape. 


2. Attach the tape drive to MAINT at virtual device number 0181: 


attach rdevno * 181 The ATTACH command attaches the real device 
TAPE 0181 ATTACHED (rdevno) to MAINT’s virtual machine at virtual 
Ready; T=n.nn/n.nn hh:mm:ss device number 0181. 


3. Load the DDRXA utility to tape. If your tape drive can operate at a density of 6250 BPI. enter the 
commands under 3a. Otherwise, enter the commands under 3b. 


a. If your tape drive can operate at a density of 6250 BPI, enter these commands: 


tape modeset (tapl den 6250 Set the tape density to 6250 BPI. If you receive 

Ready; T=n.nn/n.nn hh:mm:ss message DMSPAR622E, reissue the TAPE 
MODESET command. 

filedef in disk ip] ddrxa s @ Because this step uses the MOVEFILE 

Ready; T=n.nn/n.nn hh:mm:ss command, you must first use the FILEDEF 

filedef out tapl (den 6250 @ command to establish data definitions for files 

Ready; T=n.nn/n.nn hh:mm:ss to be copted. 


movefile in out 
Ready; T=n.nn/n.nn hh:mm:ss 


Go to substep 4. 


b. If your tape drive cannot operate at a density of 6250 BPI, enter these commands: 


filedef in disk ip] ddrxa s @ Because this step uses the MOVEFILE 

Ready; T=n.nn/n.nn hh:mm:ss command, you must first use the FILEDEF 
filedef out tapl command to establish data definitions for files 
Ready; T=n.nn/n.nn hh:mm:ss to be copied. 


movefile in out @& 
Ready; T=n.nn/n.nn hh:mm:ss 


4. Change MAINT’s virtual processor configuration to 370-XA architecture: 


set machine xa Setting the virtual machine to 370-XA architecture 
System reset causes a reset as if you entered SYSTEM CLEAR. 
System = XA If your machine is already in 370-XA mode, you 


will not get a response. 
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ip] cmsxa # 

VM/XA CMS 5.6 mm/dd/yy hh:mm 
| 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


. Rewind the scratch tape on virtual device number 0181: 


rewind 181 & 
Rewind complete 


. Load (IPL) the tape and answer the prompts from DDRXA: 


ip! 181 clear @ 


VM/XA SYSTEM PRODUCT DASD DUMP/RESTORE PROGRAM 


ENTER CARD READER ADDRESS OR CONTROL STATEMENTS 


ENTER: 


sysprint cons @ 
ENTER: 


input vdevno devtype xasres Hf 
ENTER: 


output 181 devtype (mode 6250 compact Ml 
ENTER: 


dump cpvol @ 


DUMPING XASRES 
DATA DUMPED mm/dd/yy 
AT hh.mm.ss GMT FROM XASRES 
RESTORED TO SCRATCH 
INPUT CYLINDER EXTENTS OUTPUT CYLINDER EXTENTS 


START STOP START STOP 
0000 nann 0000 nnnn 
END OF DUMP 


BYTES IN nnnnnnnnnn BYTES OUT nnannnnnnnn 
TRACKS NOT COMPACTED ON TAPE - nnannnnnnnn 


ENTER: 


a 
END OF JOB 


Wait a few moments for DDRXA to prompt you. 
If a prompt does not appear, press the ENTER 
key. 


This first control statement tells DDRXA that you 
want program messages sent to your console. 


The second control statement is the input control 
statement. vdevno is the virtual address of the 
system residence volume. (The virtual address in 
the sample HCPSYS ASSEMBLE file and USER 
DIRECT is 123.) devtype is the DASD type of 
this volume. 


This control statement specifies the device to 
which you are dumping the system. 


If your tape drive is not operating at 6250 BPI 
density, omit the mode 6250 compact option on 
this command. 


The statement DUMP CPVOL dumps cylinder 0 
and all PERM and DRCT DASD space from the 
system residence volume to the tape. 


These are informational messages. GMT means 
Greenwich Mean Time. 


The exact cylinder extents vary according to the 
device type. 


When DDRXA finishes, it prompts you with 
ENTER. To end the program, press the ENTER 
key. 
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You now have a loadable tape of the system. If you need to use this backup copy to restore CP, perform 
these steps on a first-level system: 


1. Mount the backup tape on a tape drive. 


2. Set your virtual machine to 370-XA architecture, define your virtual storage as 16 megabytes, and IPL 


CMSXA: 


set machine xa Hf 
SYSTEM RESET 

SYSTEM = XA 

define storage l6m @ 


STORAGE = 16M 
Storage cleared - system reset 
ip] cmsxa & 


VM/XA CMS 5.6 mm/dd/yy hhimm 
ai 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


. Perform a hardware load (IPL) of the tape device. 


. Use DDRXA to restore the system to disk: 


VM/XA SYSTEM PRODUCT DASD DUMP/RESTORE PROGRAM 


ENTER CARD READER ADDRESS OR CONTROL STATEMENTS 


ENTER: 


sysprint cons # 
ENTER: 


input rdevno devtype Hf 
ENTER: 


output rdevno devtype xasres @ 
ENTER: 


restore all @ 


RESTORING XASRES 
DATA DUMPED mm/dd/yy 
AT hh.mm.ss GMT FROM XASRES 
RESTORED TO XASRES 
INPUT CYLINDER EXTENTS OUTPUT CYLINDER EXTENTS 
START STOP START STOP 
0000 nann 0000 nnnn 


END OF RESTORE 
BYTES RESTORED nnannnnnnnan 


ENTER: 
a 


END OF JOB 
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If your machine is already in 370-XA mode, you 
will not get a response. 


This first control statement tells DDRXA that you 
want program messages sent to your console. 


The second control statement is the input control 
statement. Identify the device number (rdevno) 
and tape device type (3420, 3422, 3430, or 3480) 
where the backup tape 1s mounted. 


This control statement specifies the DASD device 
to which you are restoring the system (XASRES). 


The RESTORE ALL statement tells DDRXA to 
restore the whole tape to the output device. 


Informational messages: GMT means Greenwich 
Mean Time. 


The exact cylinder extents vary according to the 
device type. 


When DDRXA finishes, it prompts you with 
ENTER. To end the program, press the ENTER 
key. 
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Overview 


VM/XA System Product Release 2.1 is shipped with mixed-case American English as the system default 
national language. During installation, you can change the system default to uppercase American English. 
When VM/XA System Product Release 2.1 is completely installed, the system national language 1s 
automatically set for CP and all virtual machines on the system. 


Note: A user’s virtual machine is set to the default system national language during logon, unless the 
directory entry for that user ID contains an OPTION LANG statement that overrides the system 
national language. (See VM/XA SP Planning and Administration.) 


You can install other national languages on your system: 
¢ To replace the current default system national language. Use the procedure described in this chapter. 


e As an option available to selected system users. See VM/XA SP Planning and Administration. 


National languages (except mixed-case American English and uppercase American English) are distributed on 
national language feature tapes: one VM/XA System Product Release 2.1 tape for each language. The files 
on a national language feature tape contain translated information. The national language is identified by a 
unique 1-to 5-character langid, shown in Table 5. 


Table 5. National Language /angids and Country Codes 
Language Langid Country Code (y) 


Mixed-case American English AMENG None 


Kanji (Japan) KANJI A 


Brazilian Portuguese PORTG C 
German GER 


To install a language as the new default system national language: 


1. Load the language files from the national language feature tapes to minidisks. 

2. Identify the /angid of the new default system national language in the system generation profiles and 
update the CMS translation tables (if necessary). 

. Build a new CMS nucleus containing the CMS language files. 

. Create the CMS and CMSXA named saved systems. 

. Create the CMSINST and HELP segments. 

Build a new CP nucleus containing the CP language files. 

. Shut down the system and do a warm start to bring the new CP and CMS nuclei on line. 

. If GCS is installed, create a new GCS configuration file (optional). 

. If GCS is installed, build a new GCS nucleus containing the GCS language files. 
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Contents of the National Language Feature Tapes 


A national language feature tape for VM/XA System Product Release 2.1 contains two types of files: 


e Source files 
¢ Object code files. 


Figure 5 shows the layout of these files on the tape. 


File 1: Header 
File 2: CMS base 
File 3: CP source and object 


File 4: HELP 
File 5: CMS source 
File 6: GCS 


Figure 5. National Language Feature Tape Layout 
Source Files 


The national language source files can be edited. These source files must then converted into object files 
before the system can use them. 


Table 6. National Language Source Files 
File ID Description 


HCPMES[y] REPOS CP message repository, containing the translated versions of 
CP system messages. . 


DMSMES[y] REPOS CMS message repository, containing the translated versions of 
CMS system messages. 


DMSSPA[y] DLCS CMS command syntax file, containing the translated syntax 
definitions for CMS commands. 


DMSTRT[y] ASSEMBLE CMS uppercase translate table, mapping lowercase alphabetic 
characters to uppercase for the language. 


CSIMES[y] REPOS GCS message repository, containing the translated versions of 
GCS messages. 


XXXXXXXX HELPccce HELP files, where xxxxxxxx is the command name and cccc 
is the name of the HELP facility component. HELP files 
have the same file IDs, regardless of the language. The HELP 

files for each language installed on your system must therefore 

reside on a different disk. 


y is a “country code” character that identifies the national language and Jangid. The recognized values 
for this country code character are shown in Table 5 on page 311. These values are stored in a file 
called VMFNLS LANGLIST. 


Note: The mixed-case American English versions of translatable source files have 6-character filenames; 
they do not use the country code character. 
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Object Files 


National language object files are source files that have been converted to executable form. These files are 
used to build the new CP, CMS, or GCS nucleus during the installation procedure. 


Table 7. National Language Object Files 
File ID Description 


HCPMES[y] TEXT or TXTannnn CP message repository 

DMSMES[y] TEXT or TXTannan CMS message repository 

DMSSPA[y] TEXT or TXTnnnnn CMS system command syntax definition file 

DMSSSY[y] TEXT or TXTnnnnn CMS system national language translation and synonym table 
DMSTRT[y] TEXT or TXTnnnnn CMS uppercase translation table 

CSIMES[y] TEXT or TXTannnn GCS message repository 


y is a “country code” character that identifies the national language and /angid. The recognized values 
for this country code character are shown in Table 5 on page 311. These values are stored in a file 
called VMFNLS LANGLIST. 


The filetype of the national language object files on the national language feature tape is TEXT. When a 
file has been serviced, the filetype is changed to TXTnnnnn, where nnnnn is the number of the most 
recently applied PTF. 


Note: The mixed-case American English versions of object files have 6-character filenames; they do not 
use the country code character. 
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Procedure 


e To replace the current default system national language, use the procedure described in this chapter. 


e To install a new national language as an option available to selected system users, see VM/XA SP 
Planning and Administration. 


Notes: 


1. Perform this procedure while logged on to the MAINT user ID. 


2. Some languages have character sets that require special hardware. Be sure that all display devices in your 
configuration can properly display the character set of the new default system national language. 


Step 1. Load the Language Files from Tape to Disk 


1. Define and format a minidisk for the national language HELP files. 
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a. Map your USER DIRECT and examine the map to find a space for the new minidisk. Look fora 


gap of appropriate size and record the starting cylinder of that gap. The number of cylinders needed 
depends on the DASD type: 


Device Cylinders Needed 


3350 50 cylinders 
3375 63 cylinders 
3380 40 cylinders 
3390 38 cylinders 


You should also define a service disk for your new default system national language at this time. It 
should be the same size as the new HELP file disk. If the gap where you define your HELP file disk 
is big enough, you can define the service disk next to the HELP file disk; if not, find another gap. 


access 295 d Refer to the directory map to find a gap. 
Ready; T=n.nn/n.nn hh:mm:ss Repeat the locate command as many times as 
diskmap user direct @ necessary. When you find a suitable gap, note 
File USER DISKMAP A has been created. the starting cylinder DASD label the cylinders 
Ready; T=n.nn/n.nn hh:mm:ss reside on and and leave the file. 


xedit user diskmap @ 
locate/GAP 

qquit 

Ready; T=n.nn/n.nn hh:mm:ss 


. XEDIT your directory and add an entry for the new minidisk: 


xedit user direct @ 


locate/USER MAINT @ Locate the MAINT minidisk definitions. 
locate/MDISK Hf 
input 


MDISK 19B devtype startcyl cyls label MW ALL M@ This example uses MAINT 19B as the new 

MDISK 49B devtype startcyl cyls label MW ALL M@ minidisk and MAINT 49B as the new service 
minidisk. devtype and /abel are the device type 
and label of the DASD volume where the new 
minidisk is located. startcy/ is the starting 
cylinder of the gap where the new minidisk is 
defined. cy/s is the number of cylinders needed 
for the minidisk. 
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ai Press ENTER to return to the command line. 
file @ 


c. Map the directory again and examine the map to make sure that the new minidisks were created in 
the place you specified and that they do not overlap any existing minidisks. 


d. Issue DIRECTXA to update the directory and bring it online: 


directxa user 

VM/XA SYSTEM PRODUCT USER DIRECTORY CREATION PROGRAM - RELEASE 2.1 
HCPDIR750W RESTRICTED PASSWORD FILE NOT FOUND 

EQJ DIRECTORY UPDATED AND ONLINE 

Ready; T=n.nn/n.nn hh:mm:ss 


e. Link to the new minidisks: 


link * 19b 19b 
Ready; T=n.nn/n.nn hh:mm:ss 
link * 49b 49b Hf 
Ready; T=n.nn/n.nn hh:mm:ss 


f. Format the new minidisks: 


format 19b v (blksize 2048 Hf 

DMSFOR603R FORMAT will erase all the files on disk V(19B). 
Do you wish to continue? 
Enter 1 (YES) or 0 (NO). 

1 

DMSFOR605R Enter disk label: 

mntl9b @ 

DMSFOR733I Formatting disk V 

DMSFOR732I nn cylinders formatted on V(19B) 

Ready; T=n.nn/n.nn hh:mm:ss 


format 49b v (blksize 2048 Hi 

DMSFOR603R FORMAT will erase all the files on disk V(49B). 
Do you wish to continue? 
Enter 1 (YES) or © (NO). 

1 

DMSFOR605R Enter disk label: 

mnt49b @ 

DMSFOR733I Formatting disk V 

DMSFOR732I nn cylinders formatted on V(49B) 

Ready; T=n.nn/n.nn hh:mm:ss 


2. Attach a tape drive as to MAINT as 181: 


attach vdevno * 181 
Ready; T=n.nn/n.nn hh:mm:ss 


3. Mount the national language feature tape on device 181. The internal tape label (not the label pasted on 
the reel or cartridge) must match the label specified in SPLOAD PROFILE. The label in the SPLOAD 
PROFILE supplied by IBM is RAMINLS. Since the label varies from tape to tape, this is almost 
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certainly not the same as the internal tape label. To find out what the internal tape label is, load the first 
tape file from the feature tape and XEDIT the tape header: 


vmfplc2 load @ 

LOADING... 

$TAPE HEADER A3 

END-OF-FILE OR END OF TAPE 
Ready; T=n.nn/n.nn hh:mm:ss 
xedit $tape$ header @ 

TAPENO = 1 ; TAPEFORMAT = label 
qquit @ 

Ready; T=n.nn/n.nn hh:mm:ss 


Change every occurrence of the label in the SPLOAD PROFILE to match the internal tape label: 


xedit spload profile @ 
change/R2M1NLS/label/* * Hi 
file @ 


. Invoke ITASK EXEC with the LOAD LANG /filegroup parameters: 


Warning: The SPLOAD PROFILE determines the minidisk to which each tape file will be loaded from 
the product tape. If you change the the minidisk addresses in the SPLOAD PROFILE, you must also 
change the ITASK EXEC and the product parameter file to agree with it. 


itask load lang all @ 


DMSWSL409I Loading CP OBJECT to the 194 disk 
attached to MAINT 

DMSWSL409I Loading CMS BASE to the 193 disk 
attached to MAINT 

DMSWSL409I Loading GCS OBJECT to the 595 disk 
attached to MAINT 

DMSWSL737R Enter the minidisk address for 
the HELP files: 

19b Hf 

DMSWSL409I Loading HELP FILES to the 19B disk 
attached to MAINT 

DMSWSL409I Loading CMS SOURCE to the 393 disk 
attached to MAINT 

Ready; T=n.nn/n.nn hh:mm:ss 
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Enter all to load all of the files. Enter allobj 
instead to load only the TEXT, REPOS, and 
HELPcccc files. If you do not have all the 
VM/XA System Product Release 2.1 components 
installed in your system, issue the command with 
the cp, cms, ges, help, or cmssrce operand to load 
the files for each component that you do have 
installed. See “ITASK EXEC” on page 611. 


ITASK invokes SPLOAD EXEC to load the 
language files to the destinations specified in 
SPLOAD PROFILE, as indicated in Table 8 on 
page 317 and Table 9 on page 317. 


Notes: 


1. REPOS files for source are loaded to the 
object disks for the corresponding 
components. 


2. You are prompted for the address of the disk 
where you want the HELP files loaded. 


Table 8. National Language Source File Minidisk Destinations 


HCPMESy REPOS MAINT 194 
DMSMESy REPOS MAINT 193 
DMSSPAy DLCS MAINT 393 


DMSTRTy ASSEMBLE MAINT 393 
CSIMESy REPOS MAINT 595 


XXXXXXXX HELPccce MAINT vrdev (unique HELP disk 
for this language). The 
recommended address for the 
default system national language 
is 19B. 
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Step 2. Specify the Langid of the New Language in the System Generation 
Profiles and Update the CMS Translation Tables 


1. Establish the correct minidisk access order: 


setup @ 


2. Modify the product parameter file: 
xedit 56643089 $ppf mf 


file Hi 


The :NLS. statements in the :CP., :CMS., and 
:GCS. component areas of the product parameter 
file identify the /angid of the system national 
language for each nucleus. (There is no national 
language support for the dump viewing facility.) 
Change these statements to specify the /angid of 
the language that you are installing. Make sure 
that you specify the SAME language in each 
statement. 


3. Modify the CMS nucleus generation profile (DMSNGP ASSEMBLE): 


xedit dmsngp assemble @ 


locate/HELP @ 
change/vaddr/19B/ @ 


locate/LANGID 
change/AMENG/langid/ @ 
file i 


4. Assemble the modified DMSNGP file: 


itask assemble dmsngp & 


DMSUPD181E No update files were found 

DMSWHM1907I Assembling DMSNGP 

DMSWHM1909I DMSNGP TEXT A created 

PRT FILE fileno SENT FROM MAINT PUN AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 


Change the HELP disk address to 19B. 


Change the LANGID statement to identify the 
new language. 


If the new language contains Double-Byte 
Character Set data, change the DBCS statement to 
YES. 


ITASK invokes the SETUP EXEC to reestablish 
the minidisk access order. 


5. Copy the text deck from MAINT 191 to MAINT 395, then erase it from MAINT 191: 


copy dmsngp text a = = b (replace @ 
Ready; T=n.nn/n.nn hh:mm:ss 

erase dmsngp text a @ 

Ready; T=n.nn/n.nn hh:mm:ss 
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| Updating the CMS Translation Tables | 


The DMSTRTy ASSEMBLE file that you loaded from the language feature tape in Step | contains read-only 
system translation tables used by other CMS modules for: 


e Uppercase translation 
e 327x workstation support (displayable characters, APL, TEXT, and so on). 


You may need to update the translation tables in this file to match the language customization generated for 
your 3174/3274 controllers. You should create a language DCSS or CMS named saved system for each 
national language that you install that requires customization of your 3174/3274 controllers. 


For example, you can edit DMSTRTy using the XEDIT command with the UPDATE option: 


setup @ 
xedit dmstrty assemble * (update 


This option creates a file named DMSTRTy UPDATE that contains your changes; the source file is not 
changed. For more information about using the XEDIT command with the UPDATE option, refer to the 
VM/XA SP System Product Editor Command and Macro Reference. 


Next, create an auxiliary control file that points to your UPDATE file, and then identify the auxiliary control 
file in the CMS control file (DMSXA). For more information about control files and auxiliary control files, 


see Chapter 7, “How VM/XA System Product Uses Control Files and Update Files” on page 361. 


Finally, use the VMFNLS EXEC to generate the associated object file (DMSTRTy TEXT) that includes your 
changes: 


setup Hf 
vmfnis dmstrty assemble dmsxa 


For more information about the VMFNLS EXEC, see page 672. 


Pe End of Updating the CMS Translation Tables ee 


Chapter 5. Installing a New System National Language 319 


Step 3. Build a New CMS Nucleus Containing the CMS Language Files 


| 1. Spool punch output to your own virtual reader: 


| spool punch * 
| Ready; T=n.nn/n.nn hh:mm:ss 


2. Invoke ITASK BUILD CMS: 


itask build cms Wf ITASK invokes VMFBLD EXEC to build the 

No files changed nucleus, using the loadlist, control file, and /angid 
LOAD LIST: $$$TLL$$ EXEC Al (MNT191) specified in the product parameter file. 
RDR FILE nnnn SENT FROM MAINT PUN AS nnnn The CMS nucleus has been sent to your reader. 


RECS 026K COPY 001 N NOHOLD NOKEEP 


Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be that a 
PTF now being applied has another PTF, outside 
CMS, as a prerequisite. Check the 3}VMFBLD 
SERRLOG file for message DMSBNCI854W. 


From now on, you will receive CMS messages in the new default language, even though you have not 
finished generating CMS. 


| 3. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


| vmfview build @ 


4. Ensure that the proper files are in MAINT’s virtual reader: 


| query rdr maint all @ The ALL operand requests a display of all 
information about the reader files. 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT fileno * PUN nnnnnnnn 001 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 

Ready; T=n.nn/n.nn hh:mm:ss 
This is the file that you will IPL in substep 8 on 
page 321 below. 


| 5. Order your reader so that the CMS nucleus will be processed first: 


| order rdr fileno @ fileno is the file number of the CMS nucleus. 
| Ready; T=n.nn/n.nn hh:mm:ss 


| 6. Ensure that the virtual reader is readied for class * reader files: 


query virtual 00c @ 

RDR Q00C CL cl NOCONT NOHOLD EOF READY 
Q00C 2540 CLOSED NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 
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7. If the virtual reader is not class *, issue: 
spool rdr class * keep @ The KEEP option places the spool file in USER 
Ready; T=n.nn/n.nn hh:mm:ss HOLD status after it has been read. To remove 


this file from your reader, issue purge rdr fileno, 
where fileno is the file number of the reader file. 


8. Load (IPL) MAINT’s virtual reader: 


ipl] 00c clear @ 


| CMS Nucleus Generation Prompts and Responses | 


Note: Each of the following prompts appears only if the corresponding statement in DMSNGP is 
missing or empty (and the DEFNUC macro contains no default value), or if the DMSNGP 
statement contains a question mark (?): 


DMSINQ606R System disk address = 


a 190 is the default. 
DMSINQ615R Y-disk address = 

a 19E is the default. 
DMSINQ640R HELP disk address = 

a 19D is the default. 


DMSINQ764R Language id = 


M or longid This response identifies the /angid of your system 
national language. Text decks for this language 
are loaded into the CMS nucleus. The original 
default was AMENG (mixed-case American 
English); but you modified it in Step 2. 


DMSINQ293R Is this a DBCS language? Enter 1 (YES) or © (NO). 


M@ (or 0 M@) orl @ The default is 0 (NO). Enter 1 if the language 
that you are installing contains DBCS 
(Double-Byte Character Set) data. The only 
DBCS language currently supported is Kanji. 


DMSINQ295R Language level id = 


= The system national language does not use a level 
ID. 


DMSINQ296R Should the installation segment be used? Enter 1 (YES) or 0 (NO). 


The installation segment is an optional shared 
saved segment, into which you can place 
frequently used EXECs and System Product 
Editor (XEDIT) macros. You install the segment 
after you install your base system, but you must 
indicate now whether or not you are going to use 
it. 
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M@ (or 1 WM) or 0 


DMSINQ310R Installation segment name = 


M or segname @ 


DMSINI729R Do you want to save the system? 


0 @ 


DMSINI730R Saved system name = 


Mor sysnome @ 
DMSINI607R Rewrite the nucleus? 
1 


DMSINI608R IPL device address = 
ee 
DMSINI609R Nucleus (CYL or BLK) address 


nnn @ 


DMSINI610R Also IPL CYL/BLK 0? 
1m 
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Enter 


Enter 1 (YES) or 


The default is 1 (YES). Enter 0 if you do not 
want to use the segment. 


This prompt appears only if you accepted the 
default (or entered 1) at the previous prompt. 


Enter a 1-to 8-alphanumeric-character name for 
the installation segment, or press ENTER to 
accept the default name, CMSINST. 


1 (YES) or @ (NO). 
Answer 0 (NO). You will save CMS tn Step 4. 


The default is 1 (YES). Warning: The default 
response to this prompt does not agree with the 
sample DMSNGFP file, where SAVESYS = NO. 


You will not see this prompt if you answered 0 to 
the preceding prompt. 


The default system names are CMS and CMSXA. 
Q (NO). 


Enter 1 to write the CMS nucleus on the disk that 
you specify in your response to the next prompt. 


The default is the address of the system disk (190). 


nnn is the location on the 190 system disk where 
the new CMS nucleus is written. Enter the correct 
cylinder address for your DASD type: 


Device Cylinder Address 


3350 068 
3o75 105 
3380 066 
3390 062 


Enter 1 (YES) or © (NO). 


Enter 1 to write the initial IPL text on 
cylinder/block 0 of the disk where the CMS 
nucleus is written. 


The initial IPL text is a bootstrap program that 
reads the CMS nucleus from the cylinder/block 
where the nucleus is written (as defined in your 
response to prompt DMSINI609R). The initial 
IPL text is always written on the same 
cylinder/block as the nucleus. If the initial IPL 
text is not also written on cylinder/block 0, you 
must specify the cylinder/block address of the 
nucleus when you issue IPL commands for this 
system. For more information, refer to the 
description of the IPL command in the VM/XA 
SP CP Command Reference. 


DMSINI611R Enter version identification: The version identification is displayed each time 
that you IPL the CMS system you are now 
generating. 


M@ or version @ You can enter up to 32 descriptive characters to 
identify this version and level of CMS, or you can 
press ENTER to accept the default version 
identification, VM/XA CMS 5.6 mm/dd/yy hh:mm. 


DMSINQ612R Enter installation heading: The installation heading appears at the beginning 
of each output file created using this CMS 
nucleus. 

M or heading &@ You can enter up to 64 descriptive characters to 


serve as an installation heading, or you can press 
ENTER to accept the default heading, VM/XA 
CONVERSATIONAL MONITOR SYSTEM. 


oer End of CMS Nucleus Generation Prompts and Responses ee es, 


From this point on, messages and prompts will appear in the national language 
you are installing. 


DMSSLG283E The langid saved segment could not be /angid is your former default system national 
found; return code 44 from SEGMENT. language. 


DMSEXG3271 The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm This is the default version identification. If you 
a defined your own version identification, it appears 
here and each time that you IPL 190 or IPL CMS. 


SYNONYM SYN 
TERMINAL MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 


Saving and Printing the CMS Load Map | 


9. The CMS load map has been spooled to MAINT’s virtual printer. To save the load map on disk, issue 
the following commands: 


spool prt * nohold @ 
close prt # 


PRT FILE filenol SENT TO MAINT RDR AS fileno2 The CMS load map 1s spooled from your virtual 
RECS nnnn COPY 001 N NOHOLD NOKEEP printer to your virtual reader. 
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access 395 d Hf 
query rdr @ 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST USERFORM OPERFORM KEEP MSG 
MAINT fileno M PUN nnnnnnnn 001 NONE mn/dd hh:mm:ss SYSPROG STANDARD STANDARD OFF OFF 


The CMS load map is the file with a blank 
filename and filetype. It has approximately 8,100 
records. The exact size varies according to the 


system default language, local modifications, and 
VMSUP level. 


receive fileno2 fn ft d H 


You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as 1 —9. A, B, ©), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 


Once you have the load map saved on disk, you can print a copy of it by issuing the following command: 


print fn ft d & 


PO End of Saving and Printing the CMS Load Map ee 
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Step 4. Recreate the CMS and CMSXA Named Saved Systems 


Note: For general information about CMS as a named saved system, see VM/XA SP Guide to Saved 
Segments. 


1. Make sure: 
e You are logged on as MAINT. 


e You have finished loading all files to the 190 and 19E minidisks. After this step, any change to files 
on these disks requires resaving CMS. 


¢ You have 16 megabytes of virtual storage. To determine your storage size, issue QUERY 
VIRTUAL STORAGE. If you have less than 16 megabytes, issue DEFINE STORAGE 16M. 


e CMS is running. If not, load CMS by issuing IPL 190 CLEAR. Wait for the CMS version 
identification to appear on the screen. Then press ENTER. 


tr 


. Establish the correct minidisk order: 


access 5E5 b All your minidisk accesses are reestablished. 
vmfsetup 56643089 cms & 


Ready; T=n.nn/n.nn hh:mm:ss 


3. Invoke the SAMPNSS EXEC: 


sampnss cms cmsxa @ The SAMPNSS EXEC issues the DEFSYS 
command. 


Note: If you use “CMS” (the default name) for 
the System/370 name, users will receive the 
new level of CMS whenever they issue the 
command IPL CMS. 


HCPNSD440I Named Saved System (NSS) CMS was The SAMPNSS EXEC first issues the DEFSYS 
successfully defined in fileid fileno command to define a skeleton system data file for 
CMS and for CMSXA. These messages tell you 
HCPNSD440I Named Saved System (NSS) CMSXA was the DEFSYS commands were successful. 


successtully dehined ip tileid. 7ileno The names shown in the SAMPNSS command are 


the default names for the System/370 (CMS) and 
for the 370-XA (CMSXA) systems. Of course, 
you may name these systems whatever you wish; 
but if you change the names you must either edit 
the SAMPNSS EXEC to use your names or define 
your systems manually. 


Note: The names are positional on the command 
(the System/370 name followed by the 
370-XA name). 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS S_—onnnn mm/dd hh:mm CMS NSS MAINT 
*NSS nonn NSS S_onnnn mm/dd hh:mm CMSXA NSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss The SAMPNSS EXEC issues a QUERY NSS 


command. These messages show what system 
data files are defined. 
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4. Issue the QUERY NSS ALL MAP command to make sure CMS is defined properly. Check whether the 
information under BEGPAG, ENDPAG, TYPE, and CL in the response to QUERY NSS ALL MAP is 


the same as shown. 


query nss all map @ 

FILE FILENAME FILETYPE MINSIZE BEGPAG 

nnnn CMS NSS 000256K 00000 
00020 
Q0E00 

nnnn CMSXA NSS 000256K 00000 
00020 
QOE0O 

Ready; T=n.nn/n.nn hh:mm:ss 


ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


0000A 
90022 
OOFFF 
Q000A 
90022 
OOFFF 


EW 
EW 
SR 
EW 
EW 
SR 


S @0000 OMITTED NO 


S 00000 OMITTED NO 


5. Set your machine mode to 370, load CMS (IPL 190), and save the CMS system: 


set machine 370 @& 
SYSTEM RESET 
SYSTEM = 370 


ip] 190 clear parm savesys cms @ 


HCPNSD440I Named Saved System (NSS) CMS was 
successfully saved in fileid fileno 


DMSWSP327I The installation saved segment 


could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm 


oa 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


If your machine is already in 370 mode, you will 
not get a response. 


Load 190 with the option to save the system under 
the name CMS. 


Disregard the message about not loading the saved 
segment; CMS has been successfully saved as a 
named saved system. 


If you have changed the version heading, your 
own heading will appear. 


Press ENTER to initialize CMS. 


6. Set your machine mode to XA, load CMS (IPL 190), and save the CMSXA system: 


set machine xa 
SYSTEM RESET 
SYSTEM = XA 


ip] 190 clear parm savesys cmsxa @@ 


HCPNSD440I Named Saved System (NSS) CMSXA was 


successfully saved in fileid fileno 


DMSWSP327I The installation saved segment 


could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mn 


a 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 
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If your machine is already in 370-XA mode, you 
will not get a response. 


Load 190 with the option to save the system under 
the name CMSXA. 


Disregard the message about not loading the saved 
segment; CMSXA has been successfully saved as a 
named saved system. 


Press ENTER to initialize CMS. 


7. Set your machine mode to 370 (or XA), redefine your virtual storage to 2 megabytes, and load the CMS 
(or CMSXA) named saved system. The example below shows loading CMS in System/370 mode: 


set machine 370 If your machine is already in 370 mode, you will 
SYSTEM RESET not get a response. 

SYSTEM = 370 

define storage 2m Hf 


STORAGE = 2M Defining storage causes a system reset. 
Storage cleared - system reset 

ip] cms @ 

DMSINS327I The installation saved segment could not be loaded 

VM/XA CMS 5.6 mm/dd/yy hh:mm 


a After receiving the CMS version identification, 
SYNONYM SYN press ENTER to complete CMS or CMSXA 
CP TERM MODE VM initialization. 


Ready; T=n.nn/n.nn hh:mm:ss 


8. Check the CMS status by issuing QUERY NSS ALL and QUERY NSS ALL MAP. Check whether the 
information under FILENAME and FILETYPE in the response to QUERY NSS ALL is the same as 
shown. Also, check whether the information under BEGPAG, ENDPAG, TYPE, and CL in the 
response to QUERY NSS ALL MAP is the same as shown. The system data file should now have class 
A (rather than S$) and have one user (MAINT). 


query nss all @ 

OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 

*NSS nonn NSS A_nnnn mm/dd hh:mm:ss CMS NSS MAINT 

*NSS nonn NSS) A nnnn mm/dd hh:mm:ss CMSXA NSS MAINT 

Ready; T=n.nn/n.nn hh:mm:ss 

query nss all map @ 

FILE FILENAME FILETYPE MINSIZE BEGPAG ENDPAG TYPE CL #USERS PARMREGS VMGROUP 

nnonn CMS NSS Q000256K 00000 OOQOA EW A 00001 OMITTED NO 
Q0020 00022 EW 
QOE0O OOFFF SR 

nnnn CMSXA NSS 000256K 00000 O000A EW A 00000 OMITTED NO 
00020 00022 #£€EW 
QOE0Q OOFFF SR 

Ready; T=n.nn/n.nn hh:mm:ss 


9. Redefine your storage before you continue with the following steps: 


define storage lim @ 

STORAGE = 16M 

Storage cleared - system reset 

ip] 190 clear @ 

DMSINS327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

| 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 
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Step 5. Recreate the CMSINST and HELP Saved Segments 
Note: For more information about saved segments, see VM/XA SP Guide to Saved Segments. 
1. Log on as MAINT (unless you are continuing from the previous step). 


2. Check your virtual storage. If it is less than 16M, issue the following: 


define storage l6m @ 
STORAGE CLEARED - SYSTEM RESET 
STORAGE = 0016M 


3. IPL CMS: 


ip] cms @ 
DMSWSP327I The installation saved segment could not be loaded 


VM/XA CMS 5.6 mm/dd/yy hh:mm If you have changed the version heading, your 
own heading will appear. 


a Press ENTER to complete the CMS initialization. 
SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


4. Use the SAMPNSS EXEC to define a segment for CMSINST: 


Note: If you have increased the number of entries in the CMS load list, be sure that the DEFSEG entry 
for CMSINST in the SAMPNSS EXEC has enough pages defined to accomodate the increased 
SIze. 


access 5E5 b @ 
vmfsetup 56643089 cms Mf 


Ready; T=n.nn/n.nn hh:mm:ss 

sampnss cmsinst Hf 

HCPNSD440I Saved segment CMSINST was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS A—nnnn mn:dd hh:mm CMS NSS MAINT 


*NSS nnonn NSS) S— onnnn mm:dd hh:mm INSTHELP DCSS MAINT 
*NSS nonn NSS S— nnnn mm:dd hh:mm CMSINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


The EXEC issues a QUERY command that 
displays information about the segments defined 
for named saved systems. 


5. Define the HELP segment: 
sampnss help Hf 


HCPNSD440I Saved segment HELP was successfully 
defined in fileid fileno 
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OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS A—nnnn mm:dd hh:mm CMS NSS MAINT 
*NSS nonn NSS S— nnnn mm:idd hh:mm INSTHELP DCSS MAINT 
*NSS nnonn NSS S— onnnn mm:dd hh:mm CMSINST DCSS MAINT 
*NSS nonn NSS S_— nnnn mn:dd hh:mm HELP DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
. Save both segments: 
saveseg cmsinst # Each member saved segment defined by 


HCPNSS440I Saved segment CMSINST was 
successfully saved in fileid 
fileno 

Ready; T=n.nn/n.nn hh:mm:ss 

saveseg help @ 

HCPNSS440I Saved segment HELP was 
successfully saved in fileid 
fileno 

Ready; T=n.nn/n.nn hh:mm:ss 


. Redefine each segment to create the skeleton segments: 


sampnss cmsinst @ 
HCPNSD440I Saved segment CMSINST was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
MAINT 


*NSS nonnn NSS A-—nnnn mn:dd hh:mm CMS NSS 


*NSS nonn NSS S-— nnnn mn:dd hh:mm CMSINST  DCSS 
Ready; T=n.nn/n.nn hh:mm:ss 


sampnss help @ 
HCPNSD440I Saved segment HELP was successfully 
defined in fileid fileno 


OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
MAINT 


*NSS nonn NSS A-—onnnn mm:dd hh:mm CMS NSS 


*NSS nonn NSS S— nnnn mm:dd hh:mm CMSINST DCSS 
*NSS nonn NSS So nnnn mm:dd hh:mm HELP DCSS 
Ready; T=n.nn/n.nn hh:mm:ss 


SAMPNSS must be saved separately. 


MAINT 


MAINT 
MAINT 


. If you do not want to use the sample load list, CMSINST EXECLIST, for the DCSSGEN command, use 
the System Product Editor (XEDIT) to create your own load list: 


xedit instlist file a @ 
input # 
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* Rename RDRLIST EXEC to MAIL EXEC 
RDRLIST EXEC * MAIL = 

FILELIST EXEC S 

SYSPROF EXEC §S 

PARSE XEDIT §S 

DISCARD EXEC §S 

NOTE EXEC S 

PROFNOTE XEDIT S 

ALL XEDIT S @ 


file @ 


This is a sample. Enter the load list entries you 
need. 


Only one comment line per list is allowed; it must 
be the first line. For more information on 
creating this list, see “DCSSGEN Command” on 
page 580. 


The remainder of the lines contain entries for 
frequently used EXECs and Editor macros; 
multiple users can share the same executing copy 
of these EXECs and macros. 


Press ENTER to return to the command line. 


9. The load list must have a fixed record length in order for you to use the DCSSGEN command. If your 
load list has variable length records, change it to a fixed length file by issuing: 


copyfile fn ft fm = = = (recfm f Irecl 80 replace @ 


10. Invoke the DCSSGEN command: 


dcssgen fn ft fm cmsinst @ 


HCPNSS440I1 Saved segment CMSINST was successfully 


saved in fileid fileno 


Ready; T=n.nn/n.nn hh:mm:ss 
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Jn ft fm is the fileid of the file that contains the list 
of EXECs and Editor macros to be loaded into 
the segment, either CMSINST EXECLIST /m or 
your own file (for example, INSTLIST FILE A). 


CMSINST is the name of the segment you want 
to create. It is also the default name of the 
installation saved segment in the DMSNGP 
profile. If you changed the name in the 
DMSNGP profile, or specified a different name in 
response to the installation questions (see “Step 3. 
Build a New CMS Nucleus Containing the CMS 
Language Files” on page 320), use that name 
instead. If you do not specify a segment name, 
the DCSSGEN command defaults to CMSINST. 


The DCSSGEN command creates a load map file. CMSINST DCSSMAP A. For the sample load list 
created in substep 8 on page 329, the load map would look like this: 


* RENAME RDRLIST EXEC TO MAIL EXEC 

RDRLIST EXEC * MAIL = 
15:41:59 10/22/85 copy of RDRLIST EXEC S loaded as MAIL EXEC 
EXISBLK - 280000 FBLOCK - 280100 LENGTH - 001C40 

FILELIST EXEC S 
15:41:58 10/22/85 copy of FILELIST EXEC S loaded as FILELIST EXEC 
EXISBLK - 280020 FBLOCK - 281D40 LENGTH - 0018C8 

SYSPROF EXEC S 
7:30:18 11/26/85 copy of SYSPROF EXEC S loaded as SYSPROF EXEC 
EXISBLK - 280040 FBLOCK - 283608 LENGTH - 002178 

PARSE XEDIT S 
8:47:55 12/18/84 copy of PARSE XEDIT S loaded as PARSE XEDIT 
EXISBLK - 280060 FBLOCK - 285780 LENGTH - 0024A0 

DISCARD EXEC S 
15:40:32 10/22/85 copy of DISCARD EXEC S loaded as DISCARD EXEC 
EXISBLK - 280080 FBLOCK - 287C20 LENGTH - 0012B0 

NOTE EXEC S 
11:03:53 10/24/85 copy of NOTE EXEC S loaded as NOTE EXEC 
EXISBLK - 2800AQ FBLOCK - 288ED0 LENGTH - 005310 

PROFNOTE XEDIT S 
15:41:55 10/22/85 copy of PROFNOTE XEDIT S loaded as PROFNOTE XEDIT 
EXISBLK - 2800CQO FBLOCK - 28E1EQ LENGTH - 000980 

ALL XEDIT S$ 
15:41:05 10/22/85 copy of ALL XEDIT S loaded as ALL XEDIT 
EXISBLK - 2800E0 FBLOCK - 28EB60 LENGTH - 001298 
*** End of Source List *** 
CMSINST built at 15:56:34 on 12/02/85 


Note: When you built your CMS nucleus, if you indicated in the DMSNGP file (USEINST = YES) or in 
answer to the DMSINQ296R prompt that you wanted to use the installation segment (the default 
is YES), then this segment is used each time a user IPLs CMS. If you previously indicated that 
you did not want to use the installation segment but now want to use it, you must modify the 
DMSNGFP file to indicate that the segment should be used, then assemble the modified DMSNGP 
and rebuild CMS. (To find the latest version of the DMSNGP file, issue SETUP to access all the 
minidisks where it might be; then issue FILELIST DMSNGP ASSEMBLE *. All the copies of 
DMSNGP ASSEMBLE will be listed, with the date when each one was last modified.) 
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Messages from DCSSGEN 


While DCSSGEN is processing, you may receive error or warning messages that indicate specific 
conditions. If errors were encountered, after processing is complete you receive the following prompt: 
DMSEXG298R An error has been detected while building the DCSS. 


Do you still want the DCSS saved? 
Enter 1 (YES) or 0 (NO). 


Enter 1 to disregard the errors and save the segment, or enter 0 to not save the segment. If you do 
not save the segment, you receive the message: 


DMSEXG288I segname not saved 


If DCSSGEN encounters an error while saving the segment, you receive the message: 
DMSEXG288E dcssname not saved 


If your virtual machine is not large enough to contain the segment (you need 16M), you receive the 
message: 


DMSEXG284E The DCSS is not completely inside the virtual machine 


To correct this situation, increase the size of your virtual machine, re-IPL CMS, and reissue the 
DCSSGEN command. 


11. Define your virtual storage less than the address at which the HELP segment is to be loaded. For 
example, if the HELP segment is defined at X'C50000' (the default address in the SAMPNSS EXEC) 
define your storage as 12M. 


define storage 12m @ 
Storage cleared - system reset 
Storage = 12m 


12. Re-IPL CMS: 


ip] cms H 

DMSWSP327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

af 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


13. Issue the following commands to initialize and save the segment: 


savefd init vaddr label help @ vaddr is the unique address of the HELP file disk 
Ready; T=n.nn/n.nn hh:mm:ss for your new system default national language. 
savefd save vaddr label help @ (The recommended address is 19B.) 


DMSACP723I Z(19D) R/O 

HCPNSS440I Saved segment HELP was successfully 
saved in fileid fileno 

Ready; T=n.nn/n.nn hh:mm:ss 


label is the CMS label assigned to the disk, for 
example, MNTI9B. 


14. For more information about using the SAVEFD command to save minidisk file directory information in 
a saved segment, refer to VM/XA SP CMS Command Reference. 
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15. Verify that the CMSINST and CMSHELP segments were defined correctly: 


query nss all 


OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS = fileno NSS A_nnnn mm/dd hh:mm:ss INSTHELP NSS 
*NSS = fileno NSS A_=nnnn mn/dd hh:mm:ss CMSINST NSS 
*NSS — fileno NSS A_nnnn mm/dd hh:mm:ss HELP NSS 


. Redefine your storage before you continue: 


define storage l6m @ 

STORAGE = 16M 

Storage cleared - system reset 
ip] cms B 

VM/XA CMS 5.6 mm/dd/yy hh:mm 
a 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 
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MAINT 
MAINT 
MAINT 
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Step 6. Build a New CP Nucleus Containing the CP Language Files 


1. Spool punch output to your own virtual reader: 


spool punch * @ 
Ready; T=n.nn/n.nn hh:mm:ss 


2. Invoke the ITASK EXEC to build the CP nucleus: 

itask build cp noassem If you have not already assembled HCPSYS 
ASSEMBLE, HCPRIO ASSEMBLE, and 
HCPBOX ASSEMBLE, omit the noassem 
operand. 
If you assemble the files here, copy the text decks 
from MAINT 191 to MAINT 295. 

nonnnnnn FILES CHANGED The CP nucleus is being created. It will be sent to 

DMSACC724I 191 replaces A(191) your reader. 


DMSACC724I 391 replaces D(192) 
LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


RDR FILE fileno TO MAINT COPY 001 NOHOLD 


Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be that a 
PTF now being applied has another PTF, outside 
CP, as a prerequisite. Check the 3VMFBLD 
SERRLOG file for message DMSBNC1854W. 


3. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build 


4. Ensure that the proper files are in MAINT’s virtual reader: 


query rdr maint all @ The ALL operand requests a display of all 
information about the reader files. 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 


MAINT ~=onnnn * PUN nnannnnnn 001 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 
Ready; T=n.nn/n.nn hh:mm:ss 


5. Order your reader so that the CP nucleus will be processed first: 


order rdr fileno @ fileno is the file number of the CP nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


334 Installation and Service 


10. 


11. 


query virtual 00c @ 

RDR Q00C CL ci NOCONT NOHOLD EOF 
000C 2540 CLOSED NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 


READY 


. If the virtual reader 1s not class *, issue: 


spool rdr class * keep @ 
Ready; T=n.nn/n.nn hh:mm:ss 


. Find out how much virtual storage MAINT has: 


query virtual storage & 
STORAGE = 0016M 


define storage nnnnm 


. Ensure that the virtual reader is readied for class * reader files: 


The KEEP option places the spool file in USER 
HOLD status after it has been read. To remove 
this file from your reader, issue purge rdr fileno, 
where fileno is the file number of the reader file. 


. Perform this substep only if you are generating a CP nucleus with a virtual =real area: 


If you are generating a CP nucleus with a 
preferred virtual machine, MAINT’s virtual 
storage must be at least 3 megabytes greater than 
that specified by the VRSIZE operand in the 
SYSSTORE macro instruction in HCPSYS 
ASSEMBLE. 


Perform this substep only if you redefined MAINT’s virtual storage to a size greater than 16M: 


set machine xa @ 
STORAGE CLEARED - SYSTEM RESET 
SYSTEM = XA 


Load (IPL) MAINT’s virtual reader: 


ip] 00c & 


PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 
MSG FROM MAINT 
HCPGEN350W NUCLEUS LOADED ON XASRES 
CP ENTERED; DISABLED WAIT 
PSW O00A0000 00009010 
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Storage addresses greater than 16M require 
370-XA architecture. If your machine 1s already 
in 370-XA mode, you will not get a response. 


The 9010 disabled wait state indicates that the CP 
nucleus was successfully loaded on the system 
residence device. If you receive a different 
disabled wait state code, see VM/XA SP System 
Messages and Codes Reference. 


If you entered a disabled wait state with a code 
691, you did not observe the warning notes above. 
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12. Issue the following commands to ensure that these settings are in effect: 


set machine 370 @ If your machine is already in 370 mode, you will 
STORAGE CLEARED - SYSTEM RESET not get a response. 
SYSTEM = 370 


define storage l6m Hi 
STORAGE CLEARED - SYSTEM RESET 
STORAGE = 16M 


| Saving and Printing the CP Load Map | 


13. The CP load map has been spooled to MAINT’s virtual printer. To save the load map on disk, issue the 
following commands: 


spool prt * nohold @ The CP load map is spooled from your virtual 
close prt # printer to your virtual reader. 


ip] 190 clear @ 


After VM READ appears in the corner of your screen, issue: 


a 
access 295 d @ 
query rdr * all @ 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST USERFORM OPERFORM KEEP MSG 
MAINT fileno M PUN nnnnnnnn 001 NONE mm/dd hh:mm:ss SYSPROG STANDARD STANDARD OFF OFF 


The CP load map is the file with a blank filename 
and filetype. It has approximately 30,000 records. 
The exact size varies according to the system 
default language, local modifications, and VMSUP 
level. 


receive fileno fn ft d Hf 


You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as | —9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 


Once you have the load map saved on disk, you can print a copy of it by issuing the following 
commands: 


spool @0e class a 
print fn fi d Hf 


eee ee End of Saving and Printing the CP Load Map ere 
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Step 7. Shut Down and Do a Warm Start 


Note: If you have been using two terminals for the installation, go back to the console (the terminal where 
the OPERATOR user ID is logged on) and do this shutdown from there. After the shutdown and 
warm start are complete, OPERATOR is automatically logged on to the console again, and you can 
log on to the second terminal as MAINT. 


1. Shut down the system: 


drain all This command stops spooling operations on all 
real unit record devices. Be sure to wait until all 
devices are drained. 


RDR QOOC DRAINED SYSTEM 
PUN OOO0D DRAINED SYSTEM CLASS A 
PUN 000D FORM STANDARD MANUAL SEP 
PRT OOOE DRAINING SYSTEM CLASS A 
PRT OOOE FORM STANDARD MANUAL SEP NO03800 
PRT OOOE PRINTING MAINT FILE fileno 
RECS nnnn COPY 001 SEQ 001 
shutdown @& 
SYSTEM SHUTDOWN STARTED 
HCPGIR450W CP entered; disabled wait PSW 'QOOA0000 00000961 ' 


| First Level Only | 


2. IPL CLEAR the real address of your XASRES volume according to the directions in the Operator's 
Guide for your machine. 


ae ee ee D End of First Level Only a 
| Second Level Only | 


3. IPL your XASRES volume: 
ipl vdevy clear @ vdev is the first-level virtual address of your 


XASRES volume, which functions as a “real” 
address at second level. 


PO End of Second Level Only 
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VM/XA SYSTEM PRODUCT RELEASE 21 SERVICE LEVEL 0000; 
SYSTEM NUCLEUS CREATED ON mm/dd/yy AT hh:mm:ss, 
LOADED FROM XASRES 


KREKKKKKKKKKEKREKERKKEKKKAEKEKEKKKKKKKKKK KKK 


* LICENSED MATERIALS - PROPERTY OF IBM* 


* 
* 
5664-308 (C) COPYRIGHT IBM CORP. 1983, * 
1989. ALL RIGHTS RESERVED. ; 
US GOVERNMENT USERS RESTRICTED RIGHTS - * 
USE, DUPLICATION OR DISCLOSURE : 
RESTRICTED BY GSA ADP SCHEDULE CONTRACT * 
WITH IBM CORP. x 

* 

* 

* 


* TRADEMARK OF INTERNATIONAL BUSINESS 
MACHINES. 


KHEKKKKKKEKKKKEREKERERKERERKEKERKKKKEKKEKKKKRKKK KKK 


+ €£ *£ + © €£ ££ ££ SF F 


HCPISU951I CP VOLID volid NOT MOUNTED 


Start ((WARM|FORCE|COLD) (DRAIN) (DISABLE) (NODIRECT) ) | (SHUTDOWN) : 
warm 


It is now hh:mm:ss EDT day mm/dd/yy 
Change TOD clock (YES|NO): 


no & If the clock is not set, consult VM/XA SP Real 
System Operation for instructions on how to set it. 


The directory on volume XASRES at address nnnn 
has been brought online. 

There is no logmsg data 

FILES: NO RDR, NO PRT, NO PUN 

LOGON AT hh:mm:ss EST day mm/dd/yy 


HCPCPJ951I CP volid volid not mounted volid is a DASD volume listed on the SYSCPVOL 
: macro instruction of HCPSYS. If the volume is 
not one that you are using, ignore the message. 


You are now logged onto the OPERATOR user ID. 


STORAGE = 0016M 
FILES 0000001 RDR, QOQ0001 PRT, NO PUN 


. Define the storage that you want for the OPERATOR user ID: 


define storage 16m @ This is an example. You may define more than 
STORAGE = 0016M 16M. 
STORAGE CLEARED - SYSTEM RESET 


. Enable the devices in your revised HCPRIO file: 


enable all @ 
hh:mm:ss Command complete 
terminal mode vm 
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6. IPL 190: 


ip] 190 clear @ 

DMSWSP327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

Ready; T=n.nn/n.nn hhimn:ss 


7. Log on to the MAINT user ID by doing one of the following: 


e Issue the DISCONNECT command to disconnect the OPERATOR user ID, then log on to the 
MAINT user ID at the same device, 


OR 
e Log on as MAINT at your previously defined second terminal. 


8. If you have GCS installed in your system, complete Steps 8 and 9. 
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Step 8. Create a New GCS Configuration File (Optional) 


You may want to create a new GCS configuration file for this language. For example, you may want to 
change the authorized user IDs or add new user IDs. or you may want to change the text of your system ID 
to appear in the new language. 


If you do not want to create a new configuration file. go to “Step 9. Build and Save a New GCS Nucleus 
Containing the GCS Language Files” on page 342. 


1. Access the required minidisks: 


access 5£5 b @ 

vnfsetup 56643089 gcs (all @ 
Ready; T=n.nn/n.nn hh:mm:ss 
erase 56643089 $setup a 
Ready; T=n.nn/n.nn hh:mm:ss 


2. Set up the GROUP EXEC messages in storage: 


Note: If you do not have a full-screen display device, you cannot use the GROUP EXEC to build the 
configuration file. Do not set up the GROUP EXEC messages in storage. Refer to the VM/XA 
SP Group Control System Command and Macro Reference and use the build macros described 
there to build the configuration file manually. Then continue the language installation by 
modifying the GCS loadlist (see page 341). 


filelist csimes[y] * * @ Find the latest version of CSIMES[+] TEXT or 
TXTnnnnn. The country code identifies the 
language of your current CMS system. not the new 
language that you are installing for GCS. (Of 
course. if you have just rebuilt CMS with a new 
language, they are probably the same.) 


copyfile csimes[y] [text|txtnnnnn] fm csiume[y] text a 
This command creates a temporary GCS message 
file (containing the messages for GROUP EXEC) 
that has the filename required by the SET 
LANGUAGE command. 


set language langid (add csi user @ langid identifies the language of your current CMS 
system, not the new language that you are 
installing for GCS. (Of course. if you have just 
rebuilt CMS with a new language, they are 
probably the same.) This command sets /angid as 
the language of the temporary GCS message file 
and places the file in user storage. 
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3. Invoke the GROUP EXEC: 


group systemname 


This command assigns systemname as the filename 
of the GCS configuration file that you are creating 
and invokes the Primary Option Menu. The 
systemname parameter is optional at this time. If 
specified, 1t must match the system name in the 
DEFSYS entry for this GCS system in the 
SAMPNSS EXEC (the sample system name is 
GCS). If you specify a system name here, the 
Primary Option Menu appears with the system 
name filled in. If you do not specify a system 
name here, you must specify one on the Primary 
Option Menu. 


Note: The GROUP EXEC panels are not shown here. For guidance, refer to the procedure that you 
used to install your base system. If you used the first-level Starter System procedure, see page 80. 
If you used the second-level Starter System procedure, see page 181. If you used the existing 


system procedure, see page 278. 


from user storage and erase it from your A-disk: 


set language langid (delete csi user Bi 
erase csiume[y] text a 


5. Modify the GCS loadlist: 


filelist gcsload exec * Hf 


copyfile gcsload exec fm = = a (replace Ml 


xedit gcsload exec a Hf 


file Hf 


. After you complete the panels and exit from GROUP EXEC, remove the temporary GCS message file 


langid identifies your current system national 
language, not the one your are installing. 


Find the latest version of GCSLOAD EXEC. 


This command wnites a copy of the loadlist to 
MAINT 191 and replaces the loadlist used to 
generate the previous GCS nucleus. Do not 
modify the source file on MAINT 595. 


Locate the configuration file entry (&1 &2 &3 
GCS) in the loadlist and change the filename from 
the default (GCS) to systemname. 
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Step 9. Build and Save a New GCS Nucleus Containing the GCS Language 
Files 


1. Spool punch output to your own virtual reader: 


spool punch * @ 
Ready; T=n.nn/n.nn hh:mm:ss 


2. Invoke the ITASK EXEC with the BUILD GCS parameters: 


itask build gcs systemname systemname must match the name you specified 
when you issued the GROUP EXEC. If you do 
not specify a name, the default is GCS. 


HCPNSD440I The Named Saved System (NSS) systemname 
was successfully defined 
in fileid fileno 
OWNERID FILETYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) A—nnnan mm/dd hh:mm:ss CMS NSS MAINT 
*NSS nonn NSS A_—nnnn mm/dd hh:mm:ss CMSXA NSS MAINT 
*NSS nonn NSS) S— nonn mn/dd hh:mm:ss GCS NSS MAINT 


DMSUPD181E No update files were found 
DMSWHM1907I Assembling systemname 
DMSWHM1909I systemname TEXT A created 


Note: If you receive an assembly error, you may have to reestablish the minidisk access order. 


access 5E5 b @ 
vmfsetup 56643089 gcs (all ME erase 56643089 $setup a @ 


Then go back and check your configuration file, which ITASK has renamed systemname 
ASSEMBLE. Refer to “Planning for the Group Control System (GCS)” on page 9 for 
information regarding required fields. Correct the file or go through the GROUP EXEC panels 
again to recreate the file. (If you recreate the configuration file, you must use the same 
systemname.) After you recreate the configuration file, rename or erase the old systemname 


ASSEMBLE file, then rename the new configuration file from GROUP to ASSEMBLE. Issue the 


ITASK BUILD GCS systemname command to assemble the configuration file and to build and 
save the nucleus. 


PRT FILE fileno SENT FROM MAINT PRT AS fileno These are informational messages. You can 
RECS nnnn COPY 001 A NOHOLD NOKEEP ignore them. 
nnnnnnn FILES CHANGED 


LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


RDR FILE fileno SENT FROM MAINT PUN AS fileno The GCS nucleus has been sent to MAINT’s 
RECS nnnn COPY @01 A NOHOLD NOKEEP virtual reader. 


Ready; T=n.nn/n.nn hh:mn:ss If you get return code 4, the reason may be that a 
PTF now being applied has another PTF, outside 
GCS, as a prerequisite. Check the $VMFBLD 
SERRLOG file for message DMSBNC1854W. 
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3. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build 


. Copy the text deck, configuration file, ASSEMBLE file, and EXEC from MAINT 191 to MAINT 495: 


access 495 d 

Ready; T=n.nn/n.nn hh:mm:ss 

copy systemname text a = = d (replace Mf 
Ready; T=n.nn/n.nn hh:mm:ss 

erase systemname text a 

Ready; T=n.nn/n.nn hh:mm:ss 

copy systemname group a = =d (replace 
Ready; T=n.nn/n.nn hh:mm:ss 

erase systemname group a 

Ready; T=n.nn/n.nn hh:mm:ss 

copy systemname assemble a = = d (replace @ 
Ready; T=n.nn/n.nn hh:mm:ss 

erase systemname assemble a @ 

Ready; T=n.nn/n.nn hh:mm:ss 


. Verify that the GCS nucleus is in MAINT’s virtual reader: 


query rdr maint all @ The ALL operand requests a display of all 
information about the reader files. 

ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT = nnann * PUN nnnnnnnn 001 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 


Ready; T=n.nn/n.nn hh:mm:ss 
This is the file that you will IPL in substep 22 on 
page 88 below. It has approximately 7,600 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUP level. 


. Order your reader so that the GCS nucleus will be processed first: 


order rdr fileno @ fileno is the file number of the GCS nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


. Query the reader. If it is not class * already, spool it as class *: 


query virtual c @ 

RDR QOOC CL cl NOCONT NOHOLD EOF READY 
000C nnnn CLOSED NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 

spool c class * # 

Ready; T=n.nn/n.nn hh:mm:ss 


. Load (IPL) MAINT’s virtual reader: 


ip! 00c clear & 
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PRT FILE fileno SENT FROM MAINT PRT WAS fileno This message indicates that the GCS load map file 


RECS nnnn CPY Q01 NOHOLD NOKEEP has been sent to MAINT’s virtual printer. If you 
plan to save or print the GCS load map, record 
fileno. 


MSG FROM MAINT : CSIINI1341I systemname has nnnnnn 
bytes of available common free storage 
HCPNSS440I Named Saved System (NSS) systemname 
was successfully saved in fileid fileno 


9. IPL CMS: 


ip] cms 

DMSEXG327I The installation saved segment could not be loaded 
VM/XA CMS 5.6 mm/dd/yy hh:mm 

ie 

Ready; T=n.nn/n.nn hh:mm:ss 


Note: If necessary, purge your reader to free spool space. 


[Saving and Printing the GCS Load Map —SSSSS™E 


10. The GCS load map has been sent to MAINT’s virtual printer. To save the load map on disk, issue the 
following commands: 


query prt all @ 

OWNERID FILE CLASS RECORDS CPY HOLD DATE TIME DIST 

MAINT  fileno A PRT nonnnnnn 001 NONE mm/dd hh:mm:ss SYSPROG 

Ready; T=n.nn/n.nn hh:mm:ss The GCS load map is the file with a blank 
filename and filetype. It has approximately 2.200 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUP level. 


Note the fileno of this file. You will use it in your 
next command. 


#cp transfer prt fileno to * rdr @ 
access 495 d Hf 
receive fileno fn ft d (replace @ 


You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. yidd represents the date in four digits: last digit of the year. month (represented as | —9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 
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Once you have the load map saved on disk, you can print a copy of it by issuing the following command: 


print fn ft d @ 


eda ee End of Saving and Printing the GCS Load Map ee ree 


| Installing Multiple GCS Systems | 


11. You can install more than one GCS system, if you defined the additional systems in the system directory. 


To install each additional system: 


a. 


Reestablish the minidisk access order: 


access 5E5 b @ 
vmfsetup 56643089 gcs (all @ 
erase 56643089 $setup a @ 


. Set up the GROUP EXEC messages in storage (full-screen display devices only): 


copyfile csimes[y] [text|txtnnnnn] fm csiume[y] text a 
set language langid (add csi user 


The CSIMES text file is shipped as TXTunnnn. The most current version of this file can be 
determined by referring to the first entry in the CSIMES AUX file. In the first entry, there is a 
UMnnnnn field, where nnnnn is the PTF number. 


. Create a configuration file for each nucleus. 


e If you are using a full-screen display device, issue: 


group systemname Wl systemname is a unique filename. Then 
complete the GCS panels to define the system 
parameters. 


e If you are not using a full-screen display device, refer to VM/XA SP Group Control System 
Command and Macro Reference. Use the build macros to create the configuration file. 


. Remove the temporary GCS message file from user storage and erase it on your A-disk (full-screen 


display devices only): 


set language langid (delete csi user @ 
erase csiume[y| text a 


. For each new GCS system, add a DEFSYS statement to the SAMPNSS EXEC. For information on 


the DEFSYS command, see the VM/XA SP CP Command Reference. 
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f. For each new GCS system, add an override section at the end of the product parameter file. This 
example shows an override section for a GCS system called NEWGCS: 


sNEWGCS. GCS 

:BLD. REPLACE 

NEWGCS VMFBDNUC BUILD1 
> END. 


You must also add the name of the new GCS system to the :OVERLST. tag at the top of the 
product parameter file, for example: 


sQVERLST. CORCP CORCMS CORGCS NEWGCS 


g. For each GCS system, assemble the configuration file, build and save the new GCS nucleus, and 
copy the text deck, configuration file, ASSEMBLE file, and EXEC to the 495 disk: 


access 5E5 b @ 

vmfsetup 56643089 gcs (all @ 
erase 56643089 $setup a Mf 
itask build gcs systemname @ 
access 495 d Mf 

copy systemname text a = = 
erase systemname text a Hf 
copy systemname group a = = d (replace @ 
erase systemname group a & 

copy systemname assemble a = = d (replace @ 
erase systemname assemble a 

ip] 00c clear Hf 

ip] cms 


d (replace @ 


Before you build another GCS nucleus, save or print the GCS load map, as indicated above. 
Remember to give each load map file a different name. 


PO End of Installing Multiple GCS Systems oe 


12. 
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Verify that all your GCS segments were defined correctly: 


query nss all @ 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS = fileno NSS R_=annn mn/dd hh:mm:ss GCS NSS MAINT 
*NSS = fileno NSS R= annn mm/dd hh:mm:ss systemname NSS MAINT 
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Part 2. Servicing the System 


Part 2 of this book contains the following chapters: 


Chapter 6, “VM/XA System Product Service—An Overview” on page 349, provides an overview of the 
service tasks that you may need to perform. It also contains a description of the MAINT virtual 
machine (the user ID that you use to perform the service), and a list of the tools and EXECs you use to 
apply service. 


Chapter 7, “How VM/XA System Product Uses Control Files and Update Files” on page 361, describes 
control files and update files, and how VM/XA SP uses them. 


Chapter 8, “Files Used in PUT and COR Service” on page 371, describes the program update tape, the 
corrective service tape, and the files used in applying program update service or corrective service to 
VM/XA SP. 


Chapter -9, “Preparing For Service” on page 415, provides a procedure for establishing an alternate level 
of build disks to use when servicing your system. 


Chapter 10, “Receiving Service for CMS” on page 417, provides a procedure for receiving program 
update service or corrective service for CMS. 


Chapter 11, “Receiving Service for CP” on page 423, provides a procedure for receiving program update 
service or corrective service for CP. 


Chapter 12, “Applying Service to CMS” on page 427, provides a procedure for applying program update 
service or corrective service to CMS. 


Chapter 13, “Applying Service to CP” on page 429, provides a procedure for applying program update 
service or corrective service to CP. 


Chapter 14, “Rebuilding CMS after Applying Service” on page 431, provides a step-by-step procedure 
for rebuilding CMS after applying program update service, corrective service, or local service. 


Chapter 15, “Rebuilding CP after Applying Service” on page 487, provides a step-by-step procedure for 
rebuilding CP after applying program update service, corrective service, or local service. 


Chapter 16, “Service to DV” on page 507, outlines a procedure for receiving and applying program 
update service or corrective service to the dump viewing facility and for rebuilding the dump viewing 
facility. 

Chapter 17, “Service to GCS” on page 517, outlines a procedure for receiving and applying program 
update service or corrective service to the group control system and for rebuilding the group control 
system. ; 


Chapter 18, “Program Update Service to Licensed Programs” on page 531, outlines a procedure for 
receiving and applying program update service to products that have a product service EXEC rather than 
a product parameter file. 


Chapter 19, “Using ServiceLink to Receive Service” on page 533, describes how to use ServiceLink to 
receive service. 


Chapter 20, “Receiving and Applying Local Service” on page 543, provides a step-by-step procedure for 
receiving and applying local service to VM/XA System Product. 


Chapter 21, “Emergency Local Service Using the Patch Facility” on page 555, provides a step-by-step 
procedure for applying patches to the CP or CMS nucleus. 


Chapter 22, “Removing Service from VM/XA SP” on page 559, describes how to remove service from a 
VM/XA System Product. 
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What to Do Next 


If this is your first time servicing a VM/XA system, read these chapters before you begin servicing your 
system: 


e Chapter 6, “VM/XA System Product Service—An Overview” on page 349 
e Chapter 7, “How VM/XA System Product Uses Control Files and Update Files” on page 361 
e Chapter 8, “Files Used in PUT and COR Service” on page 371. 
Otherwise: 
e For service to CMS, CP, GCS, or DV, see Chapter 9, “Preparing For Service” on page 415. 


¢ For service to licensed programs, see Chapter 18, “Program Update Service to Licensed Programs” on 
page 531. 


e For local service, see Chapter 20, “Receiving and Applying Local Service” on page 543. 
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Chapter 6. VM/XA System Product Service—An Overview 


This chapter contains: 
An introduction to service 
An overview of program update (PUT) service 
An overview of corrective (COR) service 


An overview of local service 


A description of using the MAINT virtual machine for service 


A description of the tools and EXECs used in applying local service. 


Introduction 


The VM/XA system as installed by the customer consists of several products, such as VM/XA System 
Product, PROFS, and FORTRAN. VM/XA System Product is a product which consists of the components 
CP, CMS, GCS, and DV. Each component consists of numerous parts, such as macros, copy files, assembler 
modules, text decks, executable modules, and EXECs. Some parts are serviced by complete part replacement 
only. These parts are sometimes called object-maintained code. Other parts are serviced by combining an 
update with the base part. These parts are sometimes called source-maintained code. 


Changes to the system are provided as new parts, replacement parts, or changes (updates) to existing parts 
initially shipped on the product tape. They include: 


¢ Updates to an assembler source file (filetype is ASSEMBLE), macro (filetype is MACRO), control block 
(filetype is COPY), EXEC (filetype is SEXEC), or XEDIT macro (filetype is SXEDIT) 


¢ Replacement of existing object code (filetype is usually TXTmnnnn), EXECs (filetype is EXCnnnnn), 
XEDIT macros (filetype is XEDnnnnn) HELP files, TXTLIB files, or MODULE files 


¢ Patches to a text file (filetype is usually TXTnnnnn) for which there is no assembler source file. 


Parts serviced by replacement require the addition of a replacement part to the system. Parts serviced by 
update require the careful application of an update file to the existing control structure. 


Each problem that requires a fix from IBM is assigned an authorized problem analysis report (APAR) 
number. (The term “APAR” is ordinarily used to refer to both the fix and the report. In this book, 
“APAR” means the fix.) An APAR may contain service to more than one part. It may contain update 
service, replacement service, or both. 


A program temporary fix (PTF) is a package of APARs. For update service, the PTF contains only one 
APAR, because each update file is a change, or “delta”, to the base part. Each problem is fixed by the 
application of a separate delta. For replacement service, the PTF may contain more than one APAR, 
because replacement parts must include all previous APAR fixes in addition to the APAR fix for the problem 
being solved by the replacement. Figure 6 on page 350 shows three PTFs being applied to the system. PTF 
1 and PTF 3 each contain a single APAR consisting of an update to Part A. PTF 2 is more complex. It 
contains three APARS: APAR V, APAR W, and APAR X. All three APARs require adding a replacement 
part to Part C. APAR X also includes updates to Part A and Part B. (PTF 2 is cumulative. Two earlier 
PTF's are also available, one containing only APAR V and one containing APAR V and APAR W.) 
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Update Service Replacement Service 
Part A Part B Part C 


APAR R Update 


PTF 1 


APAR X Update} |APAR X Update 


PTF 2 PTF 2 


APAR Z Update 


PTF 3 


Figure 6. Update Service and Replacement Service 


Service is the process of applying fixes (PTFs) to the system after installation. Problems fall into these 
categories: 


¢ A PTF is available on the latest program update tape (PUT). 
¢ A PTF is available, but no PUT is available. 
¢ No PTF is available. 


These circumstances determine the format in which the service is supplied. This, in turn, decides the 
procedure for applying it. These procedures are: 


¢ Program update service: 


— A PTF is available. 
~ The PTF is supplied on a PUT tape. 
— The PTF is automatically applied. 


e Corrective service: 


A PTF is available, but no PUT is available. 
~ The PTF is supplied on a COR tape. 
— The PTF is automatically applied. 


e Local service: 


No PTF is available. 3 

The service is originated by the customer, or is supplied by IBM on a tape other than a PUT a COR 
tape, in hard copy, or over the telephone. 

The service is manually applied. 


The service may correct the problem or circumvent it (branch around or otherwise avoid the code in 
which the problem occurs). 


Note: These classifications have nothing to do with the classification of service as update service or 


replacement service. PUT service, COR service, and local service can all require either updates or 
replacement. 


Application of PTFs on the PUT uses the procedure called program update service because its input comes 
from the program update tape. Massive application of PTFs on the PUT is intended to avoid problems. For 
this reason, program update service is sometimes called preventive service. 


When a problem occurs for which a PTF does not exist on the latest PUT, IBM will provide a corrective fix 
if the problem is known and the PTF is ready for the next PUT. Corrective service comes on a COR tape 
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with the same format as the PUT tape. It is applied in essentially the same way as PUT service. A PTF can 
be ordered correctively even if it is already on a PUT tape. 


If the problem is not known, IBM may be able to provide a temporary circumvention over the phone for a 
severe problem. (Circumventive service may also be provided on tape.) The circumvention usually does not 
fix the problem, but prevents failure by disabling the failing function. In this book, service that does not 
come from a PUT or COR tape is called local service, even when you get it from IBM. 


Local service for replacement parts is like the procedure used for update parts, except that you do not need 
to assemble replacements for object code. Once updates are applied and assemblies are completed, update 
parts and replacement parts are the same. | 


For parts on replacement service there are two circumventive procedures. One procedure, the patch facility, 
is for the CP nucleus and CMS nucleus. The other procedure uses ZAP for CP utilities and command 
modules not in the nucleus. 


Program Update Service Overview 


All IBM customers have a Customer Profile at IBM Software Manufacturing and Distribution, or ISMD 
(formerly known as ISD or PID). This profile lists all the licensed program products for each customer. 
ISMD distributes PUT tapes that are tailored to the Customer Profile—this is how you receive PUT service 
for your licensed program products. 


PUT service is sent out to VM/XA SP customers either on a regular basis or when you request it. It arrives 
in the form of a Program Update Tape (or PUT), which you apply automatically using a set of EXECs. The 
PUT, which may be one or more tape volumes, contains service files for one or more program products. 


The PUT is cumulative. All update files up to the current level are included. For parts serviced by updates 
(source-maintained code), the latest text deck, which includes all APARs up to the current level, is also 
shipped. For parts serviced by replacement (object-maintained code), a deck is shipped for each PTF ‘and 
will be reshipped for several PUT cycles. 


The VMFREC EXEC is used to load PUT service for each VM/XA System Product component to the 
appropriate DELTA disk as specified in the product parameter file (PPF). The VMFAPPLY EXEC is used 
to apply it and to build the AUX control structure on the specified APPLY disk. The VMFBLD EXEC is 
used to build your nucleus after you receive and apply service. These EXECs are supplied on the VM/XA 
System Product product tape. 


For products other than VM/XA System Product, the service files include a CMS service EXEC for each 
program product on the PUT. The service EXEC is especially designed for that program product. 
VMFREC maps the PUT and calls the appropriate service EXEC for each product, other than VM/XA 
System Product, being serviced. 


The PUT also contains an EXEC called VMSERV, for compatibility. For products other than VM/XA 
System Product, you can use VMSERV as an alternative to VMFREC. Mount the tape on a tape drive, load 
the first tape file under CMS, and invoke the VMSERV EXEC. VMSERV supervises the installation of PUT 
service for the program products you have. 
The format of each volume of the PUT is as follows: 

e The first tape file contains the PUT DOCUMENT and the VMSERV EXEC. 

¢ The second tape file contains a Memo to Users for each program product service on the volume. 


e The remaining tape files contain service files for the program products on that volume. 
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When you invoke the VMFREC EXEC with the INFO (MEMOS option, you can load the PUT document 
and all memos to users to disk and print them. You must read the instructions on the PUT document and 
the Memo to Users before you continue PUT service installation. 


Specific instructions for receiving and applying PUT service and for rebuilding components afterwards are 
found in Chapter 9 through Chapter 18. 


Corrective Service Overview 


Corrective service is service IBM sends you to correct a specific problem that you or another customer has 
encountered and reported. It is sent on a corrective service tape, which has the same format as the PUT 
tape. It is applied the same way as PUT service (see “Program Update Service Overview” on page 351). 


Specific instructions for receiving and applying corrective service and for rebuilding components afterwards 
are found in Chapter 9 through Chapter 17. 


Local Service Overview 


Local service is any service that is not supplied on a PUT or COR tape. It can be service that you originate, 
or service that is sent to you by IBM to correct or circumvent a specific problem that you have encountered 
and reported. 
You will manually perform the following general steps for local maintenance: 
1. Receive the following files to the alternate LOCAL] disk: 
e Source update files 
¢ Replacement files 
2. Apply the fixes by creating auxiliary control files on the alternate LOCALI disk 
3. Build these changes into an alternate running system on the new BUILD! disk. 


Specific instructions for receiving and applying local service are found in Chapter 20, “Receiving and 
Applying Local Service” on page 543. 


Specific instructions for rebuilding components afterwards are found in Chapter 14 through Chapter 17. 


The MAINT Virtual Machine 


By convention, the MAINT virtual machine is used to perform installation and service tasks. (Your 
installation may use a different virtual machine or machines.) MAINT’s directory entry is part of the sample 
file. USER DIRECT, that is supplied with the starter system. The sample directory is printed in 

Appendix C, “VM/XA System Product Starter System Information” on page 725. You may wish to alter 
MAINT’s virtual machine configuration, but remember that IBM created the configuration with the service 
process in mind. 
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Minidisks form an important part of MAINT’s configuration. The strategy IBM follows is to separate key 
files onto different minidisk strings. A string is a set of minidisks defined in the product parameter file (see 
“The Product Parameter File” on page 384) for a particular use. The different strings defined in the product 
parameter file are: 


String 
TASK 
LOCAL 
APPLY 
DELTA 
BASE!1 
BASE2 
BUILDI 


BUILD2-n 
SYSTEM 


Use 

Service tools build disk. 

Updates, replacement parts, and auxiliary control files for local service. 
Auxiliary control files generated by the VMFAPPLY EXEC. 

Updates and replacement parts from the PUT or COR tape. 

Object code. 

Source code. 


The system built from the base code on the BASE disks plus the updates on the DELTA! and 
LOCALI disks. 


System disk extensions—exact use varies by component. For example, the HELP files are here. 


Minidisks belonging to other components that must be accessed. 


When there is more than one minidisk in a string, the minidisks act as layers of service. The leftmost disk, as 
defined in the PPF, is the alternate minidisk and the rightmost disk is the production disk. Service levels are 
promoted (or merged) towards the production disk as service levels are tested and accepted. 


MAINT’s service minidisks are described in Table 10 on page 354. 
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Table 10 (Page 1 of 3). MAINT’s Minidisks for System Service 
sk Contents 
Service tools build disk. 


4 


Comp. 
CP TASK 
LOCALI 


APPLY 


0295 Update files for local service to CP. 


0492 New CP control disk containing CP AUX files which have been 
generated from text files by VMFAPPLY. 


Intermediate merge of CP APPLY disks. 
Cumulative merge of previous levels of CP APPLY disks. 


0291 


CP DELTAI | 0594 CP text files or update files containing program temporary fixes 


(PTFs—also known as CP service files) from the PUT. 
Intermediate merge of CP DELTAI disks. 

Cumulative merge of previous levels of CP DELTAI disks. 
CP text files, load lists, control files, and MACLIBs. 

CP source files, macro definitions, and copy files. 


New CP minidisk of the system residence pack, used by MAINT to 
perform CP nucleus generation, directory maintenance, and DASD 
reallocation. | 


0294 


BASE1 
BASE2 
BUILD1 


0394 
0423 


0123 Current IPLable CP nucleus and system disk. Files are not merged 


from 423 to 123. 


049D New mixed-case American English HELP files for CP, CMS, and 
GCS. 


Current mixed-case American English HELP files for CP, CMS, and 
GCS. Files are not merged from 49D to 19D. 


New uppercase American English HELP files for CP, CMS, and GCS. 


Current uppercase American English HELP files for CP, CMS, and 
GCS. Files are not merged from 49C to 19C. 


New CMS system disk containing CMS modules, control file, and 
CMS MACLIBs. 


0190 Current CMS system disk containing CMS modules, control file, and 
CMS MACLIBs. Files are not merged from 490 to 190. 


MAINT’s work minidisk. 


BUILD2 


BUILD3 | 049C 


019C 


BUILD4 | 0490 


SYSTEM 
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Table 10 (Page 2 of 3). MAINT’s Minidisks for System Service 


Service tools build disk. 
Update files for local service to CMS. 


CMS, 05E5 
APPLY 0692 New CMS control disk containing CMS AUX files which have been 
generated from text files by VMFAPPLY. 
0391 Intermediate merge of CMS APPLY disks. 
0392 Cumulative merge of previous levels of CMS APPLY disks. 
DELTAI | 0593 CMS text files or update files containing program temporary fixes 
(PTFs—also known as CMS service files) from the PUT. 
_ Intermediate merge of CMS DELTAI disks. 


0293 Cumulative merge of previous levels of CMS DELTAI disks. 
BASEI CMS text files, CMS generation and utility tools, IOCP, and the dump 
BASE2 0393 


viewing facility. 
CMS, BUILD1 0490 New CMS system disk containing CMS modules, control file, and 
DV | CMS MACLIBs. 
Current CMS system disk containing CMS modules, control file, and 
CMS MACLIBs. Files are not merged from 490 to 190. 
BUILD2 | 049D New mixed-case American English HELP files for CP, CMS, and 
GCS. 
Current mixed-case American English HELP files for CP, CMS, and 
GCS. Files are not merged from 49D to 19D. 
BUILD3 | 0501 New CMS system disk for EREP files. 


CMS source files, macro definitions, and control blocks. 


New uppercase American English HELP files for CP, CMS, and GCS. 


BUILD4 | 049C 
a. 
GCS. Files are not merged from 49C to 19C. 


Note: For service to the CMS and DV components, the CP minidisks on the SYSTEM string are 
required in order to access the CP macro libraries. 
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Table 10 (Page 3 of 3). MAINT’s Minidisks for System Service 


String Contents 


| GCS TASK 0S5ES5 Service tools build disk. 
| LOCALI 
APPLY 
CS 


0495 Update files for local service to GCS. 
G DELTAI 
| 
BASE1 
BUILD! 
BUILD2 
BUILD3 
BUILD4 
| 
| 
BUILDS 
| 
| 
| SYSTEM 


0892 New GCS AUX files which have been generated by VMFAPPLY and 
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UPDATE shells created by VMFREC. 
Intermediate merge of GCS APPLY disks. 


GCS current cumulative merge of AUX files which have been 
generated by VMFAPPLY and UPDATE shells created by VMFREC. 


New GCS text files, update files and AUX files. 
Intermediate merge of GCS DELTAI disks. 


GCS current cumulative merge of text files and update files from 
previous levels of PUT. 


GCS text files, load lists, control files, and MACLIBs. 
New GCS system. 
Current GCS system. 


0592 


0896 
0791 


0895 


089E New GCS system extensions. 
Current GCS system extensions. 


049D New mixed-case American English HELP files for CP, CMS, and 


Current mixed-case American English HELP files for CP, CMS, and 
GCS. Files are not merged from 49D to 19D. 


New uppercase American English HELP files for CP, CMS, and GCS. 


Current uppercase American English HELP files for CP, CMS, and 
GCS. Files are not merged from 49C to 19C. 


0490 New CMS system disk containing CMS modules, control file, and 
CMS MACLIBs. 


Current CMS system disk containing CMS modules, control file, and 
CMS MACLIBs. Files are not merged from 490 to 190. 


MAINT’s work minidisk. 


049C 
019C 


ee ee ee 
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Figure 7. Alternate, Intermediate Alternate, and Current Minidisks for System Service 


MAINT’s minidisk configuration allows a multilevel updating scheme that preserves the data integrity of the 
source code and allows you to build a system with the latest updates. The organization of MAINT’s 
minidisks is shown in Figure 7. This layout allows you to build a new system on the alternate minidisks 
without altering your running system and lets you back out to the old system if necessary. When you are 
satisfied with your new system, the alternate disks are copied to the current system’s disks so that the 
alternate disks can be used to build your next system. 
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The disk layout in Figure 7 on page 357 is created on the following principles: 


I. 


Never change anything IBM sends you. To be sure this does not happen, never write-link to a disk you 
do not want to write on. The BASE disks can be read-only during service. The DELTA disks can be 
read-only except when VMFREC and VMFAPPLY are running. 


. Keep components separate from each other, so that (for example) changes to CP will not affect CMS. 


. Keep locally applied service separate from IBM service, so that changes to the LOCAL disk will not 


inadvertently change IBM service on the DELTA disk. 


. Keep base release installation separate from service, so that applying service will not inadvertently change 


the original product as installed on the BASE disks. 


. Keep alternates for DELTA disks so that you can back out. 


Plan for backout in case something goes wrong when you apply service. Alternates make reconstruction 
of the previous level easier. 


. Keep an alternate BUILD disk. 


Do not change the system while it is running. An alternate BUILD disk minimizes the amount of 
reconstruction necessary to back out. 


Tools and EXECs Used During the Service Process 


You need to use many different programs and EXECs during the service procedure. Below is a partial list of 


the programs and EXECs you will use: 


VMFREC Use VMFREC to load product service from a tape to your system. This EXEC is required 


for VM/XA System Product service. It is compatible with VMSERV and existing product 
service EXECs. You can use it to load the tape document and all Memos to Users for that 
tape as well as to map the tape. The map is compatible with VMSERV. 


For more information on VMFREC, see “VMFREC EXEC” on page 691. 


VMFAPPLY Use VMFAPPLY with the APPLY list to create AUX files for those PTFs being added to 


your system. 


For more information on VMFAPPLY, see “VMFAPPLY EXEC” on page 645. 


VMFMAC The VMFMAC EXEC updates and rebuilds macro libraries. 


For more information on VMFMAC, see “VMFMAC EXEC” on page 665. 


VMENLS The VMFNLS EXEC updates national language-related files (for example, message 


repositories). 


For more information on VMFNLS, see “VMFNLS EXEC” on page 672. 


VMFHASM VMFHASM invokes the UPDATE command to automatically incorporate update files for a 


particular ASSEMBLE file into a temporary copy of the ASSEMBLE file, then invokes the 
H Assembler to assemble the copy. The assembled files (called TEXT files) are used when 
the system is regenerated by the VMFBLD EXEC. 


For more information on VMFHASM, see “VMFHASM EXEC” on page 657. 


VMFBLD Use VMFBLD to build the nucleus parts of VM/XA System Product. 


For more information on VMFBLD, see “VMFBLD EXEC” on page 652. 
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VMFOVER 


VMFPLC 


VMFPLCD 


VMFPLC2 


VMFSETUP 


VMFVIEW 


VMSERV 


XEDIT 


The VMFOVER EXEC makes a temporary copy of one component section from the product 
parameter file with changes made in accordance with the override section of the product 
parameter file or a separate PPF override file. The other service and installation EXECs use 
this copy instead of the base product parameter file. 


For more information on VMFOVER, see “VMFOVER EXEC” on page 677. 


VMFPLC calls either VMFPLCD or VMFPLC2. VMFPLC supports the VMFPLCD and 
VMFPLC2 command formats. A ROUTE function allows VMFPLC to establish command 
routing for subsequent VMFPLCD or VMFPLC2 commands issued by VMFPLC. 


For more information on VMFPLC, see “VMFPLC EXEC” on page 679. 


VMFPLCD loads files from an envelope file, dumps CMS files to the envelope file, loads 
previously dumped files to the envelope file, and performs control operations on the envelope 
file. 


For more information on VMFPLCD, see “VMFPLCD EXEC” on page 681. 


-VMFPLC72 loads all or a specified number of files from tape. Directions for its use as a 


command appear in the PUT document; it is also automatically invoked by VMFREC, 
VMSERYV, and product service EXECs. 


For more information on VMFPLC2, see “VMFPLC2 Command” on page 687. 


The VMFSETUP EXEC is invoked by the other service EXECs to set up the minidisk access 
order. 


For more information on VMFSETUP, see “VMFSETUP EXEC” on page 700. 


The VMFVIEW EXEC invokes XEDIT to allow you to view the exception logs. Using 
VMFVIEW’s PF key assignments, you can view all the messages of a specific type, all the 
messages of a specific number, the HELP screen for a particular message, and move 
backwards and forwards through the displayed exception log. 


For more information on VMFVIEW, see “VMFVIEW EXEC” on page 702. 


VMFREC has superseded VMSERV, but you may continue to use the VMSERV EXEC to 
install products other than VM/XA System Product from the PUT. This EXEC is in the first 
file on a PUT; it can be used to print the PUT document and all memos to users for that 
PUT. 


XEDIT is the CMS editor shipped with VM/XA System Product. Use it to create control 
files in the local service procedure. 


If you need information on using XEDIT, see VM/XA SP System Product Editor Command 
and Macro Reference, or VM/XA SP System Product Editor User's Guide. 
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Chapter 7. How VM/XA System Product Uses Control Files 
and Update Files 


This chapter describes: 


e What control files, auxiliary control files, and update files are 
e File-naming conventions used in VM/XA SP service procedures 
e How different control files can be used to create different systems. 


The VM/XA System Product service process relies heavily on CMS files called control files. Each component 
of VM/XA System Product has at least one control file structure. 


There are control files, auxiliary control files, and the actual update files (also called service files). These files 
may have the following generic filetypes: 


Filetype File Contents 

CNTRL Control file. 

AUXXxxxx Auxiliary control file. xxxxx is up to 5 alphabetic or numeric characters. 

UPDTxxxx Update (listed in a CNTRL file; this is not recommended because it makes tracking 
difficult). xxxx is up to four alphabetic or numeric characters. 

Ammmmmxx Update (listed in an AUX file). mmmmm is an APAR number and xx is HP (for CP 


and dump viewing facility assembler source and object updates), PP (for other CP and 
dump viewing facility object updates), DS (for CMS modules), or CI (for GCS). 


EmmmmmDS CMS macro update (listed in an AUX file). mmmmm is an APAR number. 

Control files may be extremely simple or quite elaborate, but their important function is to allow you to 
control those changes necessary to tailor your system to meet your current needs. Each structure of control 
files is a tree with the main control file at the base, auxiliary control files branching off from the main control 
file, and update files branching off from the auxiliary control files. 


Control File Auxiliary Control Files Update Files 


HCPXA CNTRL HCPXXX AUXXA HCPXXX A12345HP 


H12346HP 


HCPXXX A12346HP 
Figure 8. Service File Structure 


| 


Figure 8 shows the main CP control file, together with an auxiliary control file and its corresponding update 
files. (There are actually many auxiliary control files with update files). The control fille HCPXA CNTRL 
contains several lines, one of which is the filetype of the VM/XA SP auxiliary control files (AUXXA). Every 
assemble file, macro, control block file, EXEC, or XEDIT macro, that has had service applied to it has a 
corresponding auxiliary control file called fn AUXxxxxx, where fn is the filename of the file that has been 
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serviced. (For example, the auxiliary control file for PUT service to HCPKXX ASSEMBLE is HCPXXX 
AUXXA.) Each auxiliary control file, in turn, contains the filetypes of the update files that have been 
applied. 


Figure 8 on page 361 applies to all components of VM/XA SP. The structure for all components is 
identical, except that the main control filename and update file suffix vary (for example, the CMS main 
control file is called DMSXA CNTRL instead of HCPXA CNTRL; and the update file suffix is DS). 


Control Files 


Control files are used in: 


Updating assembler source files and EXECs using XEDIT 
Updating control blocks and macros using XEDIT 

Creating and updating AUX files using VMFAPPLY 
Assembling source code using the VMFHASM EXEC procedure 
Patching object code using the PATCH facility 

Building MACLIBs using the VMFMAC EXEC procedure 
Regenerating updated EXECs using EXECUPDT 

Creating an executable CP or CMS nucleus using VMFBLD 
Generating CP utilities using UTILITY 

Generating CMS modules using CMSGEND. 


Control files are used by the CMS UPDATE command. The EXECUPDT, XEDIT, VMFMAC, and 
VMFHASM procedures invoke UPDATE with the CTL option to modify source files. The VMFAPPLY, 
VMFBLD, and HCPLDR programs also use the control file structure directly; usually the same control file is 
used by all these procedures for a given product or component. For the purposes of product service, all the 
procedures require that the control file must have a filetype of CNTRL. The control filename is unique for 
each VM/SP XA component. The VM product control filenames and their contents are provided in “Main 
Control Files” on page 364. 


Sample Control File 
For an understanding of how the update procedures work, you should be familiar with the elements in a 
control file. A sample control file for the VM/XA System Product system is shown in Figure 9. 


TEXT MACS HCPGPI HCPPSI HCPOM1] HCPOM2 CPLIB DMSGPI DMSOM OSMACRO 
PAT AUXPAT TX$ ™* Local Patches 


LCL AUXLCL LCL * Local Modifications 
TEXT AUXXA * IBM Put Service, COR service, and SUP reach-ahead 


Figure 9. Sample Control File— HCPXA CNTRL 


There are usually three types of records in a control file: MACS records, AUX file identification records, 
and comments. (A fourth type, update file identification records, will work but should be avoided.) 


MACS Records 


A control file must have at least one MACS record. It must appear before any AUX file identification 
records. The first field in the MACS record is the update level identifier. You can think of this as a name 
field. If no update files are found, the filetype of the assembled text deck will be derived from the update 
level identifier on the MACS record: TEXT if the update level identifier is TEXT and TXT xxxxx, where 
xxxxx is the update level identifier, if it is anything else. 
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The remaining fields in the MACS record are the names of macro libraries. VMFHASM uses the library list 
from the MACS record to issue a GLOBAL command before assembling the updated source file. The 
number of macro libraries on a MACS record is limited by the number that can fit on an 80-character line. 
The total number of macro libraries specified on all the MACs records cannot exceed 63. The libraries are 
searched in the order specified on the MACS record. 


AUX File Identification Records 


A control file can have any number of AUX file identification (AUXxxxxx) records. The first field in an 
AUX file identification record is the update level identifier. If the auxiliary control file named in this record 
is found, but the top entry in the auxiliary control file contains no PTF number or local tracking number, the 
filetype of the assembled text deck will be derived from the update level identifier on the AUX file 
identification record: TEXT if the update level identifier is TEXT and TXTxxxxx, where xxxxx is the 
update level identifier, if it is anything else. (If more than one auxiliary control file is listed, the last one 
found—the one named on the top auxiliary control file identification record—determines the text deck 
filetype.) 


The second field (sometimes called the update ID) is the filetype of the auxiliary control file. The characters 
AUX identify an auxiliary control file that lists additional fixes to be applied; AUXLCL in this example. 
AUXXA is the VM/XA System Product auxiliary control file, listing updates distributed by IBM. This file is 
listed at the bottom of the control file so that these updates are applied first. (Note that the file is read from 
the bottom to the top by UPDATE and from the top to the bottom by VMFBLD. UPDATE applies IBM 
changes first and local changes last, while VMFHASM names the text file, and VMFBLD finds it, according 
to the last change applied.) 


Note: Service supplied by IBM for VM/XA System Product does not use preferred AUX files, but they are 
supported. If you wish to use them, see “Preferred AUX File” on page 639. 


The preferred AUX file identifier is an optional field. There can be 1 to n preferred AUX files. Each token 
in this field must be 4 to 8 characters in length. Preferred AUX files are only valid when the UPDT/AUX 
file identifier specifies an AUX file. If a preferred AUX file exists, the line in the control file with the 
preferred AUX file is ignored and the line above it is used. If a preferred AUX file does not exist, it uses the 
line in the control file. The file specified by the preferred AUX file identifier does not have to be an AUX 
file, it can be as update file as well. 


The text deck prefix is an optional field. It can come before or after the patch indicator field. The text deck 
prefix must be 3 characters in length. This field is used to derive the filetypes of text decks. If this field is 
not present, the default TXT is used. The text deck prefix cannot be TX$ or AUX. 


The patch indicator is an optional field. It can come before or after the text deck prefix field. This field 
simply indicates that the AUX file specified by the UPDT/AUX file identification field may contain patch 
updates. If this field is not present on an UPDT/AUX file identification record, patch updates are not 
permitted for this record. 


If the characters PTF appear in the level identifier field, the UPDATE command will take the second field as 
the filetype of an update file even if it begins with AUX. 


Comments 

A control file can have any number of comment records. Comment records are identified by an asterisk (*) 
in the first column. They may appear anywhere in the control file. Comments may also appear at the end of 
control records. They begin with an asterisk. 

For the UPDATE command only, any field that follows the UPDT/AUX file identifier field that is less than 


four or more than eight characters long is taken to be the beginning of the comment field. This is possible 
because UPDATE does not use the text deck prefix or the patch indicator fields. 
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Update File Identification Records 


For compatibility with other VM systems, VM/XA System Product also supports update file identification 
records in control files. Avoid using them if possible, because an update listed in a control file must be called 
UPDTxxxx. The four variable characters are not enough to identify the APAR with which this update is 
associated, essential information for tracking. List updates in an auxiliary control file, where the name can 
include an APAR number. 


Varying Control Files to Generate Multiple Systems 


By varying the control files, you can build different versions of your system from a single set of AUX and 
update files. For example, you might have the following files: 


¢ PRODSYS CNTRL: 


*THIS IS A SAMPLE CNTRL FILE 

*DO NOT USE THIS FILE 

TEXT MACS HCPGPI HCPPSI HCPOM1 HCPOM2 CPLIB DMSGPI DMSOM OSMACRO 
LC2 AUXLCL2 LCL TX$ 

Pl AUXP1 

TEXT AUXXA 


¢ TESTSYS CNTRL: 


*THIS IS A SAMPLE CNTRL FILE 

*DO NOT USE THIS FILE 

TEXT MACS TESTLIB HCPGPI HCPPSI HCPOM1 HCPOM2 CPLIB DMSGPI DMSOM OSMACRO 
LC1 AUXLCLI LCT TX$ * FREE FORM COMMENT 

LC2 AUXLCL2 LCL TX$ 

P1 AUXP1 

TEXT AUXXA 


Notes: 


1. The control file for the test system contains one more level of updates (the record beginning with LC1) 
than the control file for the production system. When all the updates listed in the auxiliary control files 
have been applied, the system built with the test control file will contain more updated files than the 
system built with the production control file. Both control files serve as the base of a tree using the same 
set of AUX and update files, but the test tree has branches not in the production tree. It is not necessary 
to keep two sets of AUX and update files. 


2. The test system includes one more macro library (TESTLIB) than the production system. 


Main Control Files 


CP, CMS, CMS macros, DV, GCS, and the VM/XA SP loader each have a main control file. The contents 
of these main control files are shown below. 


The contents of HCPXA CNTRL (control file for CP) are: 


TEXT MACS HCPGPI HCPPSI HCPOM1 HCPOM2 CPLIB DMSGPI DMSOM OSMACRO 
PAT AUXPAT TX$ ™* Local Patches 

LCL AUXLCL LCL * Local Modifications 

TEXT AUXXA * IBM Put Service, COR service, and SUP reach-ahead 
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The contents of DMSXA CNTRL (control file for CMS) are: 


TEXT MACS DMSGPI DMSOM OSMACRO CPLIB 

PAT AUXPAT TX$ * Local Patches 

LCL AUXLCL LCL * Local Modifications 

TEXT AUXXA * IBM Put Service, COR service, and SUP reach-ahead 


The contents of DMSMXA CNTRL (control file for CMS macros) are: 


TEXT MACS 

PAT AUXMPAT TX$ * Local Patches 

LCL AUXMLCL LCL * Local Modifications 

TEXT AUXXA * IBM Put Service, COR service, and SUP reach-ahead 


The contents of HCSXA CNTRL (control file for dump viewing facility) are: 


TEXT MACS HCSOCO HCPGPI HCPPSI HCPOM1 HCPOM2 CPLIB DMSGPI DMSOM OSMACRO 
PAT AUXPAT TX$ * Local Patches 

LCL AUXLCL LCL * Local Modifications 

TEXT AUXXA * IBM Put Service, COR service, and SUP reach-ahead 


The contents of CSIXA CNTRL (control file for GCS) are: 


TEXT MACS CSIGPI CSIOM DMSGPI DMSOM 

PAT AUXPAT TX$ * LOCAL PATCHES 

LCL AUXLCL LCL * LOCAL MODIFICATIONS 

TEXT AUXXA * IBM Put Service, COR service, and SUP reach-ahead 


The contents of HCPLDRCM CNTRL (control file for the VM/XA SP loader) are: 


TEXT MACS HCPLDRCM HCPGPI HCPPSI HCPOM1 HCPOM2 CPLIB DMSGPI DMSOM OSMACRO 
TEXT AUXCMS 
TEXT AUXXA 


Notes: 
1. HCPLDRCM CNTRL is used only to assemble the VM/XA SP loader. 


2. All the service EXECs obtain the control filename from the product parameter file, except UTILITY 
EXEC, which always uses HCPXA CNTRL. HCPXA CNTRL is the usual control file for CP and for 
utilities. 


Local Control Files 


The IBM-supplied control files already provide for one level of local service; but when you create files for 
local service or updates of VM/XA System Product modules, you may still need to create a local control file. 
A local control file is a copy of the appropriate VM/XA System Product control file with an entry for each 
local auxiliary control file and the filename of your local MACLIB. For example, the file CPLCL CNTRL 
may contain: 


TEXT MACS YOURMAC HCPGPI HCPPSI HCPOM1 HCPOM2 CPLIB DMSGPI DMSOM OSMACRO 
LCT AUXLCT LCT * TEST UPDATES 

LCL AUXLCL LCL 

TEXT AUXXA 


Note: Control files (CNTRL) and auxiliary control files (AUXxxxxx) are read from the bottom up when 
updates are applied. The IBM-supplied auxiliary files should be the bottom entry in the control file so 
that during assembly the IBM updates are applied first. 
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Auxiliary Control Files 


When auxiliary control files are distributed by IBM for VM/XA System Product, they have the filetype 
AUXXA. If an auxiliary control file is not distributed, it must be created by VMFAPPLY. Figure 10 on 
page 366 shows a sample auxiliary control file for source updates. Figure 11 on page 366 shows a sample 
auxiliary control file for patches to text decks. 


Update ft 


(APAR #) PUT Level PTF # Comments 
A12567HP 201 UM98765 * COMMENT DESCRIBING FIX 


Figure 10. Sample Auxiliary Control File for Source Updates 


Update ft Patch 
(Patch #) Indicator APAR # Comments 
P23877 TX$ V¥M23877 * A PATCH TO BE REPLACED BY APAR VM23877 


Figure 11. Sample Auxiliary Control File for Patches to Text Decks 


For local source updates, a local tracking number takes the place of the PTF number in the auxiliary control 
file. Like the PTF number, a local tracking number has seven characters (two letters followed by five 
numbers). 


When the text deck filetype is created, the two letters of the PTF number or local tracking number are 


ignored. The five numbers are appended to the text deck filetype prefix if one is present in the main control 
file. If no text deck filetype prefix is found, TXT is used as the prefix. 


Update Files 


Update files can contain: 


¢ Updates to source code 
e Patches to object code 
¢ Requisite information. 


All of the PTF and update files distributed by VM/XA System Product are assigned filetypes as follows: 


Update Fi PAR Nembe 


AmmmmmHP TXTnnnnn 
AmmmmmPP EXCnnnnn 
AmmmmmDS 


AmmmmmCI 
EmmmmmDS 


XEDnnnnn 
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Where: 


A 
indicates a VM/XA SP update. 


E 
indicates a VM/XA SP CMS macro update. 


HP 
is the 2-character identifier for VM/XA System Product CP and dump viewing facility assembler source 
and object updates. 


PP 
is the 2-character identifier for other VM/XA System Product CP and dump viewing facility updates. 


DS 
is the 2-character identifier for VM/XA System Product CMS. 


CI 
is the 2-character identifier for VM/XA System Product GCS. 


mmmmm 
is an APAR number. You can enter the command FILELIST * *mmmmm* * to see a listing of all the 
modules affected by APAR mmmmm. The filename is the same as the module name. Browse the AUX 
file for any one of these modules to find the corresponding PTF number. 


nnnnn 
is a PTF number. You can enter the command FILELIST * *nnnnn* * to see a listing of all the modules 
affected by PTF nnnnn. The filename is the same as the module name. Browse the AUX file for any one 
of these modules to find the corresponding APAR number. 


For example, the code and fixes to answer APAR VM12567 against the CP module HCPCFM in VM/XA 
System Product are contained in the file HCPCFM A12567HP. 

The file HCPCFM AUXXA contains the entry: 

Al2567HP 201 UM98765 *COMMENT DESCRIBING FIX 

UM98765 is the PTF corresponding to APAR VM12567. If UM98765 is the last PTF applied to HCPCFM, 
the assembled text deck will be called HCPCFM TXT98765. 


For your local updates, assign a local tracking number with the format LCnnnnn, where the prefix LC 
indicates a local fix. The five numeric digits of the local tracking number can be used to name text decks in 
the same way as the five numeric digits of the PTF number. 


Source Update Files 


Source update files are named filename XnnnnnYY, where: 


e filename is the name of the part being serviced 
e¢ mnnnn is the APAR number 
¢ X/YY is the value assigned to the :SLVI. tag in the product parameter file. 


Each source update file contains: 
¢ Requisite information, consisting of PREREQ, CO-REQ, and IF-REQ entries 
¢ DEPEND entries added by VMFAPPLY, identifying any PTFs for which this PTF is a requisite 


¢ Update control statements and assembler language statements defining an effective change to a module’s 
source code. (These changes are actually made as object code is created.) 


Chapter 7. Control Files and Update Files 367 


Source update files are shipped on the PUT or COR tape. When a source update is applied, VUFAPPLY 
changes the filemode of the update file from 1 to 5. Figure 12 is an example of a source update file. 


Y¥M33332 VM31452 
: NONE 
: NONE 
: A33330DS A34594DS 
./ I 09180600 $ 9182600 2000 08/16/88 20:56:22 


T™ MISFLAG2 ,OSTYPLD WAS THIS AN OS TYPE LOAD? @VA33331 
* (WERE WE CALLED BY DMSSLN?) @VA33331 

BO LDRB0O231 Don't reset EPA to new value @VA33331 
./ I 09190000 $ 9190506 500 08/16/88 20:56:22 
LDRBO231 DS OH @VA33331 


Figure 12, Example of a Source Update File—DMSLDR A33331DS 
Patch Update Files 


The customer creates patch update files for parts of the CP nucleus, CMS nucleus, and GCS nucleus serviced 
by replacement; that is, parts for which no source code is available. Patch update files contain: 


¢ Requisite information, consisting of PREREQ, CO-REQ, and optional IF-REQ entries. 


¢ VERIFY and REPLACE statements that effectively change the object code as the nucleus is created. 
When you apply a patch update, change the filemode of the update file from 1 to 5. Figure 13 is an 
example of a patch update file. 


./ * * PREREQ: NONE 

/ * * CO-REQ: NONE 

./ * NAME HCPAFF 

./ * * This is a patch. It 
./ * * will be replaced by 
/ * * — APAR VM23877. 

./ * VER 61C 0780 

./ * REP 61C 0700 


Figure 13. A Sample Patch Update File 


Update Shells 


VMFREC creates update shells on the APPLY disk for parts on replacement service. Update shells use the 
same naming convention as update files. An update shell takes the place of the source update file that would 
exist if the part were on update service. Update shells contain requisite information and DEPEND entries 
(created by VMFAPPLY), but no executable code. Like source update files, update shells have the module 
name for a filename and a filetype derived from the APAR number. When the PTF associated with the 
APAR is applied, VMFAPPLY changes the filemode of the update shell from 1 to 5. Figure 14 is an 
example of an update file shell. | 


./ * PREREQ: NONE 
./ * CO-REQ: NONE 


./ * IF-REQ: NONE 
./ * * THIS IS AN UPDATE FILE SHELL 


Figure 14. Example of an Update File Shell— DMSMGC A34362DS 
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Guidelines for Using Update Files 


1. Keep each fix (patch or APAR) in a separate update file. This applies to both source updates and patch 
fixes. Several files may be required to make a single fix (this happens when the same fix applies to 
several parts), but you should never have several fixes in the same file. 


Each fix should have a unique identifier for control purposes. This identifier is the filetype of the update 
file. If the same fix applies to several parts, there should be a file for each part, all with the same 
filetype. 


2. Keep all local fix descriptions for the same part in the same AUX file, unless a fix applies to a different 
control file level. 


Local fixes for the same part should not be distributed over AUX files (different control file levels) 
arbitrarily. Local service should be easily distinguished from IBM service and should always be applied 
last. Local service can be distributed over separate control files for the purpose of maintaining different 
service levels with a single structure of AUX and update files. Each level can be built from a different 
control file containing only the desired level identifiers. 


3. Never place local patches in AUX files from IBM. In other words, keep your local service separate from 
IBM service. Local service should be easily distinguished from IBM service and should always be applied 
last. 


4. Patches to text files should be applied only when no source file is available. If you do apply text file 
patches when source code is available, they should be converted to source updates and reassembled 
before they are moved from a test environment to a production-level system. 


Building local source updates on top of local text file patches for the same part will lead to confusion. 


5. Do not place the names of update files directly in the main control file. Place update filenames in an 
auxiliary control file. 


If you place the update filename in the main control file instead of an auxiliary control file, the update 
file’s filetype must be UPDTxxxx. If you place it in an auxiliary control file, the update file’s filetype 

can be derived from the APAR number, and you can specify the text deck’s filetype (derived from the 

PTF number). These filetypes are used during assembly and nucleus build. 
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Chapter 8. Files Used in PUT and COR Service 


This chapter describes: 


e The files used in applying PUT and COR service 
e The program update tape (PUT) 
e The COR tape. 


Files Used in PUT and COR Service 


Besides the source or object code to be updated, the following files are used to apply PUT and COR service: 


PUT document 

COR document 

PUT descriptor file 

COR descriptor file 
Product contents directory 
Memo to Users 

Text decks 

Text shells 

PTF parts list 

Apply list 

Exclude list 

Exception log 

Receive history file 

Load list 

Temporary load list 

Load map 

Restart indicator files 
Product parameter file 
Product parameter override file 
Temporary product parameter file 
Service disk map. 
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| The Tape Document 
| © PUT DOCUMENT 


| The PUT document describes the service procedure for the PUT tape. It lists the steps involved in 
applying service to the system, and contains a description of the VMSERV EXEC. (Other service 
installation EXECs are described in the Memo to Users.) Read the PUT document before you try to 
apply service. 


| @« COR DOCUMENT 


| The COR document describes the service procedure for the COR tape. It lists the steps involved in 
| applying service to the system, and contains an explanation of the service EXECs. Read the COR 
document before you try to apply service. 


| The Tape Descriptor File 
¢ PUT Descriptor File - PUT nnnnn 


The PUT descriptor file is a directory of the products and components for which service is contained on 
the program update tape. It shows how many files are available for each product and component and 
where they are. The PUT descriptor file is called PUT mann, where nnnn is the PUT number. Figure 15 
on page 373 is an example of the tape descriptor file. 


The first record of the PUT descriptor file states that it applies to a PUT tape. (This record distinguishes 
the PUT descriptor file from the COR descriptor file described below.) The second record tells how 
many volumes the tape has and which volume this is. If there is more than one volume, the PUT 
descriptor file appears on each volume, but describes the whole tape. 


The other records are the multivolume directory. A :VOLmn record indicates the beginning of each 
volume. Each of the 3-word records following a :VOLmn. record describes a group of tape files. (A tape 
file is the data between two tape marks. It may contain more than one CMS file.) If the first two words 
are PUT FILES, that group of files is the two standard tape files that begin every volume of the PUT 

| tape: one containing the PUT descriptor file and PUT DOCUMENT, and the other containing 

| informational files about all the products for which service is supplied on the tape (see Figure 29 on 
page 412). Otherwise, the first word names the product to which the files apply; the second word ts 
either HDR (meaning a header file) or the name of the component to which the files apply. The third 
word is always the number of files in the group. 


Note: A product may be entirely on a single volume (prodid/); that it may cross volumes at a 
component break (prodid2); or that a single component may span multiple volumes (prodid3 
comp2). In the case of a product (or component) crossing a volume boundary, the break will be 
indicated in the product contents directory by the inclusion of a :WOLmn record, where nn 
indicates the continuation volume. 


¢ COR Descriptor File - COR ymdd 


The COR descriptor file is a directory of the products and components for which service is contained on 
the corrective service tape. It shows how many files are available for each product and component and 
where they are. The COR descriptor file is called COR ymdd, where y is the last digit of the year, m is 
the month (numbered 1 —C in hexadecimal), and dd is the day; for example, 8B05 is November 5, 1988. 
The COR descriptor file has the same format as the PUT descriptor file (see Figure 15 on page 373). 
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PUT nnnn COR ymdd 


VM System Program Update Tape VM Corrective Service Tape 9110 1X660 PSIP SP2NP31 
89/01/10 14:02:04.157208 

VOLan of 03 VOLO1 of 01 

:VOLO1. :VOLO1 

PUT FILES COR Q2 

prodid1 HDR 56643089 HDR 

prodidl compl 56643089 CP 

prodidl comp2 56643089 CMS 


prodidl comp3 56643089 DV 
prodid2 HDR 56643089 GCS 
prodid2 compl 


prodid2 comp2 
:VOLO2. 

PUT FILES 
prodid2 HDR 
prodid2 comp3 
prodid2 comp4 
prodid3 HDR 
prodid3 compl 
prodid3 comp2 
:VOLO3. 

PUT FILES 
prodid3 HDR 
prodid3 comp2 
prodid3 comp3 


Figure 15. Example of Tape Descriptor Files 


The Product Contents Directory 


There is a product contents directory for each new format product serviced on the PUT or COR tape. The 
product contents directory lists the tape files supplied for each component of each product, and must be 
repeated if the product crosses a tape boundary. The product contents directory can be seen as an expansion 
of the PUT descriptor file or COR descriptor file: the descriptor file tells you how many files you have and 
where they are; the product contents directory tells you what the files listed in the descriptor file are. 

Figure 16 on page 374 is an example of a product contents directory. 


The filename of the product contents directory is the product ID. The filetype is: 
¢ On the PUT tape: $PUTnnnn, where nnnn is the PUT number 


¢ On the COR tape: $CORymdd, where y is the last digit of the year, m is the month (numbered 1—C in 
hexadecimal), and dd is the day; for example, 8B05 is November 5, 1988. 
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prodidi $PUTnnnn 


:VOLO1. 
:CP. 
AXLIST 
PARTLST 
UPDT 
TEXT 
MACAUX 
MACUPDT 
SOURCE 
MACLIB 
EXEC 
RESV 


MACUPDT 


prodidl $CORymdd 


:CMS 
AXLIST 
PARTLST 
UPDT 
TEXT 
MODULE 


Figure 16. Examples of Product Contents Directories 


The Memo to Users — 56643089 MEMO 


You'll receive a Memo to Users for each licensed program that needs service. The Memo contains 
instructions for servicing each program, and describes the service installation EXEC (if any) for each 
program. You should read the Memo for each licensed program before you try to apply service. 


The Memo to Users for VM/XA System Product Release 2.1 is called 56643089 MEMO. 
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Text Decks 


The self-documenting text decks for CP and CMS service contain a prolog with the following information: 


1. A description of the APAR, including the APAR number, PUT level, PTF number, and content (from 
the AUX file) 


2. Prerequisites and corequisites for this service, consisting of PREREQ, CO-REQ, and IF-REQ entries and 
agreeing with the requisites in the update file and update shell 


3. A date and time stamp 


4. The macro libraries used (optional). 
The text decks also contain assembler text consisting of ESD, TXT, RLD, and END cards. 


If the filetype of an update file listed in a text deck begins with a percent sign (%), that update is listed in the 
control file and not in an auxiliary control file. Figure 17 is an example of a text deck. 


A33398DS 203 UM90033 NLS FILE NAMING CONVENTIONS ENHANCEMENT 

- DMSMGC A33398DS C1 XA1396 09/13/88 14:34:32 

* PREREQ: NONE 

* CO-REQ: NONE 

* IF-REQ: NONE 

pensec 203 UMO4083 GENMSG CALCULATES INDEX PAST END OF PAGE. 
DMSMGC A34362DS A5 XA1191 11/03/88 13:03:06 

* PREREQ: NONE 

* CO-REQ: NONE 

IF-REQ: NONE 

DMSSP = MACLIB S2 XA1390 10/21/88 10:43:25 


DMSMGC DMSTSP1 Al XA1191 11/03/88 13:10:22 


Figure 17. Example of a Text Deck -DMSMGC TXT04083 


Text Shells 


VMFREC creates a text shell on the DELTA disk for each PTF listed in the prolog of a text deck for which 
neither a text deck nor a text shell is available on the PUT or on the DELTA or LOCAL minidisks. The text 


shell contains: 


1. A description of the APAR, including the APAR number, PUT level, PTF number, and content (from 
the AUX file) 


2. Prerequisites and corequisites for this service, consisting of PREREQ, CO-REQ, and IF-REQ entries and 
agreeing with the requisites in the update file and update shell 


3. A date and time stamp 


4. The macro libraries used (optional). 


The text shell does not include the executable text. VMFBLD will not accept a text shell as input. The shell 
is provided so that a search by PTF number will identify all the modules affected by the PTF. 
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If the filetype of an update file listed in a text shell begins with a percent sign (%), that update is listed in the 
control file and not in an auxiliary control file. Figure 18 on page 376 is an example of a text shell. 


neeracn 203 UM96033 NLS FILE NAMING CONVENTIONS ENHANCEMENT 
DMSMGC A33398DS C1 XA1396 09/13/88 14:34:32 

* PREREQ: NONE 

* CO-REQ: NONE 

* IF-REQ: NONE 


A34362DS 203 UM04Q83 GENMSG CALCULATES INDEX PAST END OF PAGE. 
ig DMSMGC A34362DS A5 XA1191 11/03/88 13:03:06 

* PREREQ: NONE 

* CO-REQ: NONE 

* IF-REQ: NONE 


Figure 18. Example of a Text Shell—DMSMGC TXT04083 


The PTF Parts List 


The filename of the PTF (program temporary fix) parts list is the PTF number and the filetype is 
$PTFPART. It contains a list of the parts needed to install the PTF. This list should identify the 
appropriate text file even when the text file is not shipped on the PUT. The filemode of the PTF parts list is 
changed to filemode 5 after the PTF is applied. 


The Apply List 


The apply list contains a list of the PTFs to be applied to a product. The first line in the apply list is always _ 
a comment identifying the product and PUT level. An asterisk (*) indicates a comment and may be used to 
exclude a PTF. Figure 19 is an example of an apply list. 


* APPLY LIST FOR PRODUCT 56643089 COR 0109 

*VM Corrective Service Tape 0169 1X952 CSD 4817505 90/01/09 11:35:39.755240 
UM12083 VM37944 

UM12090 VM38482 

UM12091 VM38575 


UM12092 VM38430 
UM12093 VM38247 
UM12094 VM37999 
UM12095 VM38821 
UM12096 VM38676 


Figure 19. Example of an Apply List- DMSXA $APPLIST 


The PUT contains an apply list for each PUT level and one for all the levels on the PUT tape. The filename 
of the apply list on the service tape is the same as the filename of the control file specified in the product 
parameter file. (If you change the filename of the control file in the PPF, the filename of the apply list is 
automatically changed too.) The filetype is: 


¢ For PUT service: 
— $APPmnnn for the apply list associated with a single PUT level, where nnnn is the PUT level 
— $APPALL for the cumulative apply list 
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e For COR service: 


~- $APCymdd for the apply list associated with a single COR tape, where ymdd is the date (last digit of 
the year, month numbered in hexadecimal, day) 


— $APCALL for the cumulative apply list. 


VMFREC will copy the cumulative apply list to a file whose filetype is SAPPLIST, and append any 
cumulative apply list it finds on the intermediate alternate disk(s). fm $APPLIST is the apply list used by the 
VMFAPPLY EXEC. If you want VMFAPPLY to use a different apply list, you must copy it with a filetype 
of $APPLIST. (Use the REPLACE option.) Copy it instead of renaming it so that you are sure to keep the 
apply list you used. 


The Exclude List 


The exclude list contains a list of the PTFs that are not to be applied to a product, even though they are 
listed in the apply list. Entries must be in the same order as in the apply list. The first line in the exclude list 
is always a comment identifying the product and PUT level. Figure 20 is an example of an exclude list. 


* EXCLUDE LIST FOR PRODUCT 56643089 COR 9110 
UM03601 
UM9G033 


Figure 20. Example of an Exclude List—- DMSXA SEXCLIST 


The PUT contains an exclude list for each PUT level and one for all the levels on the PUT tape. The 
filename of the exclude list on the service tape is the same as the filename of the control file and apply list. 
The filetype is: 


¢ For PUT service: 
— $EXPnnnn for the exclude list associated with a single PUT level, where nnnn is the PUT level 
— $EXPALL for the cumulative exclude list 

¢ For COR service: 


— $EXCymdd for the exclude list associated with a single COR tape, where ymdd is the date (last digit 
of the year, month numbered in hexadecimal, day) 


— $EXCALL for the cumulative exclude list. 


VMFREC will copy the cumulative exclude list to a file whose filetype is SEXCLIST, and append any 
cumulative exclude list it finds on the intermediate alternate disk(s). fn SEXCLIST is the exclude list used by 
the VMFAPPLY EXEC. If you want VMFAPPLY to use a different exclude list, you must copy it with a 
filetype of SEXCLIST. (Use the REPLACE option.) Copy it instead of renaming it so that you are sure to 
keep the exclude list you used. 


Note: If two PTFs are in the same text deck, you cannot exclude the first unless you also exclude the second, 
even if you list the first one on the exclude list. This restriction applies because the first PTF is 
considered to be a prereqisite for the second PTF. 


If you list the first PTF in the exclude list, but not the second, and if the second PTF appears in the 


apply list, both PTFs are applied. You receive an error message indicating that a PTF you wanted to 
exclude has been applied. 


Chapter 8. Files Used in Service 377 


The Exception Log 


The exception log is called SVMF xxx SERRLOG, where xxx can be: 


¢ REC for the receive exception log created by the VMFREC EXEC 
e APP for the apply exception log created by the VMFAPPLY EXEC 
e BLD for the build exception log created by the VMFBLD EXEC. 


The exception log contains any error or informational messages issued by its corresponding EXEC and is 
written to the A-disk. If the exception log already exists when the EXEC is invoked, a date and time stamp 
is inserted to separate the earlier log entries from the new entries. You should browse the exception log with 
the VMFVIEW EXEC after VMFREC, VMFAPPLY, or VMFBLD finishes processing. Table 11 shows 
the different types of messages that may appear in an exception log. 


Note: All messages except status messages must be investigated. A warning message does not necessarily 
mean that anything is wrong, but you cannot be sure until you check it out. 


Exception logs are cumulative. The most recent entries are at the top. 
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The Receive Exception Log 


KKEKKEKKKEKEKEEEREKEKEKEEEEKEKEEREKEREREREEREEEREREKREREREREREEREERER 


eenay RECEIVE - 02/28/90 - 13:53:15 - run sis 


HKKKAKKKKKKKKEKKKKEKEEKKEKEREEEKEEEEKEEEEREREEREEREEEEEEEEUEREERKKEE 


EEE Product: 56643089 Component: CMS diataiaal 
AKEKKKEKECEKKKKEEEEEEEEEEEEEEKEEEEREKREEEEEEEREKEEEEEEEKEEKEREKKEEK 
ST:DMSREC1852I This is VOLO1 of 01, level 9C22 COR TAPE. 
WN:DMSREC1968W The Service Enhancements part set on DISK is at an 


WNs 

ST: DMSREC19671 
ST: 

ST:DMSREC18061 
ST: 

ST:DMSREC18041 
ST: DMSREC19401 
ST: DMSREC18511 
ST: DMSREC18511 
ST: DMSREC18511 
ST:DMSREC18511I 
ST:DMSREC18511 
ST:DMSREC1851I 
ST:DMSREC18511 
ST:DMSREC18511 
ST:DMSREC18511 
ST:DMSREC18511 


UNKNOWN level. 

The Service Enhancements part set in the TAPE header 
files is at the 8902.2 level. 

The current SERVICE DISKMAP file contains 

the map of the mounted tape. 

Receiving service for component CMS of product 56643089 
Merge processing is not required for component CMS. 
Processing AXLIST with the part handler VMFRCAXL EXEC. 
Processing PARTLST with the part handler VMFRCCOM EXEC. 
Processing UPDT with the part handler VMFRCUPD EXEC. 
Processing TEXT with the part handler VMFRCTXT EXEC. 
Processing MACAUX with the part handler VMFRCAUX EXEC. 
Processing MACUPDT with the part handler VMFRCUPD EXEC. 
Processing SOURCE with the part handler VMFRCCOM EXEC. 
Processing EXEC with the part handler VMFRCCOM EXEC. 
Processing HELP with the part handler VMFRCCOM EXEC. 
Processing HELP with the part handler VMFRCUPP EXEC. 


ST:DMSREC1850I The processing for RESV by the VMFRCCOM EXEC was bypassed. 


HEAKKKEKKHEKEEEKEEKKERKREEEEEREREEREEEERERRREKREEEKEEEREEKEEREREEEEEE 


eeeee = RECEIVE - 02/28/90 - 13:49:59 - run = *###* 


REREKEEAEKEREKEREREERERERERRERECERREREERERREREREEREREERERERERREREE 


kkkkk INFO option kkkkek 
KEKKAKKKAEKKEKEEEEKEREKRERREEKEEUEEAREEREEEREREREEKREREKEREKERKEEKS 
ST:DMSREC1852I This is VOLQ1 of 01, level 9C22 COR TAPE. 
WN:DMSREC1968W The Service Enhancements part set on DISK is at an 


ecm ce wm mw ee ees ee ee 


WNs 
ST: DMSREC1967I 
ST: 


UNKNOWN level. 
The Service Enhancements part set in the TAPE header 
files is at the 8902.2 level. 


Figure 21. Example of a Receive Exception Log - SVMFREC $3ERRLOG 
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The Apply Exception Log 


REKKEKCREKKEEKKEEKEKREEEREREREREKEREEREREREEEEKREEERREEERERKKKRKERRKKS 


eee APPLY = - «02/28/90 = - «=Ss:14201246 - run = *#**E 


ARKEKKKEKEKKREKEKEEEKEEKEEKERERRREEREREEEEREREREREREKEEEEREREREEREE 


SEARS Product: 56643089 Component: CMS Sexe 


AREKKEEEKKEKEKEKEKEREREREREEERKEEREEREKEEREREKERRERURRREEREREEKAKEEE 


ec cc cc cc ce se ee eee ee 


MNT191 
MNT5E5 
MNT692 
MNT391 
MNT392 
MNT593 
MNT691 
MNT293 
MNT395 
MNT193 
MNT393 
MNT490 
MNT49D 
MNT5OQ1 
MNT49C 
MNT295 
MNT594 
MNT190 
MNT591 
MNT294 
MNT194 194 

MNTI19E 19E 

ST: BDMSAPP18531 
ST:DMSAPP18511 
ST:DMSAPP18511 
BD: DMSAPX18581 
ST:DMSAPP18531 
ST sDMSAPP18511 
ST:DMSAPP18511 
BD: DMSAPX18581 
ST: DMSAPP18531 
ST :DMSAPP18511 
BD: DMSWAU18581 
ST:DMSAPP18511 
ST: DMSAPP18511 
ST: DMSAPP18511 
ST: DMSAPP18531 
ST: DMSAPP18511 
ST: DMSAPP18511 


191 
5E5 
692 
391 
392 
593 
691 
293 
395 
193 
393 
490 
49D 
901 
49C 
295 
594 
190 
591 
294 


Figure 22 (Part 1 


<_CcaA nnwmwovwveoe2wtarAA are SS Oones oD > 
wm 
~~ 
= 


Processing PTF UM12083 

Processing DMSDSK A37944DS with the part handler VMFAPCOM EXEC. 
Processing DMSDSK TXT12083 with the part handler VMFAPTXT EXEC. 
DMSDSK TEXT has been serviced. 

Processing PTF UM12090 

Processing DMSLBM A38482DS with the part handler VMFAPCOM EXEC. 
Processing DMSLBM TXT12090 with the part handler VMFAPTXT EXEC. 
DMSLBM TEXT has been serviced. 

Processing PTF UM12091 

Processing HELPXED AUXXA with the part handler VMFAPAUX EXEC. 
HELPXED AUXXA has been serviced. 

Processing HELPXED A38575DS with the part handler VMFAPCOM EXEC. 
Processing HELPXED XED12091 with the part handler VMFAPCOM EXEC. 
Processing HELPXED XEDIT with the part handler VMFAPCOM EXEC. 
Processing PTF UM12092 

Processing DMSCIT A38430DS with the part handler VMFAPCOM EXEC. 
Processing DMSCIT TXT12092 with the part handler VMFAPTXT EXEC. 


of 2). Example of an Apply Exception Log -$VMFAPP SERRLOG 


380 Installation and Service 


BD: DMSAPX18581 
BD: 

ST: DMSAPP18531 
ST: DMSAPP1851I 
ST: DMSAPP1851I 
ST: DMSAPP18531 
ST: DMSAPP1851I 
ST: DMSAPP1851I 
ST: DMSAPP18531 
ST: DMSAPP18511 
BD : DMSWAU18581 
ST: DMSAPP18511 
ST: DMSAPP18511 
ST: DMSAPP1851] 
ST: DMSAPP18531 
ST: DMSAPP18511 
ST: DMSAPP1851I 


CMSLOAD build list contains files that 

have been serviced. 

Processing PTF UM12093 

Processing DMSDSK A38247DS with the part handler VMFAPCOM EXEC. 
Processing DMSDSK TXT12093 with the part handler VMFAPTXT EXEC. 
Processing PTF UM12094 

Processing DMSCRD A37999DS with the part handler VMFAPCOM EXEC. 
Processing DMSCRD TXT12094 with the part handler VMFAPTXT EXEC. 
Processing PTF UM12095 

Processing VMFAPPLY AUXXA with the part handler VMFAPAUX EXEC. 
VMFAPPLY AUXXA has been serviced. 

Processing VMFAPPLY A38821DS with the part handler VMFAPCOM EXEC. 
Processing VMFAPPLY EXC12095 with the part handler VMFAPCOM EXEC. 
Processing VMFAPPLY EXEC with the part handler VMFAPCOM EXEC. 
Processing PTF UM12096 

Processing GENMOD HCM12096 with the part handler VMFAPCOM EXEC. 
Processing GENMOD HELPCMS with the part handler VMFAPCOM EXEC. 


| Figure 22 (Part 2 of 2). Example of an Apply Exception Log -SVMFAPP SERRLOG 


The Build Exception Log 


HRREKEKRKEKEEKKEKEEKEREKKEREREKREREREEEREREEEEEEERREREREEEERERREREKRE 


weeee = BUILD «= = «02/28/90 = - ~Ss«14215:29 - run | *#*E* 


‘N 
HEKKKCKKEEKEKEEEKKEEREEEEEREREEEEREREREREERERERRREEEREEREEERREREREEE 


So aad Product: 56643089 Component: CMS REEER 


HRKIEKEKEEEKREREEEEEEEREREREREEKREREEEEEEREREEREREREREEEERERERREREEE 


ST:DMSBLD1851I Processing CMSLOAD with the part handler VMFBDNUC EXEC. 
ST:DMSBLD1851I Processing CPYSYSCM with the part handler VMFBDCPY EXEC. 
ST:DMSBLD1851I Processing CPYBTHCM with the part handler VMFBDCPY EXEC. 


| Figure 23. Example of a Build Exception Log-—S$VMFBLD SERRLOG 


The Receive History Log 


The receive history log has a filename of SVMFREC and a filetype of SHISTORY. The receive history log 
contains a list of all CMS files received from the PUT when VMFPLC2 is invoked by VMFREC for any 
component of VM/XA SP, and shows the date and time when each file is received. 


Note: Files loaded from tape using any of the INFO options of VMFREC EXEC do not appear in the 
receive history log. Therefore, the various tape documents, the service disk map, and the service 
EXECs will not appear in the receive history log. 


The receive history log is cumulative. It differs from the exception logs in that the most recent entries are at 
the bottom. 
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REEKEREKREEEEEEREREEERERRERERREEREERERRR AK KREKKKEKKIK 


Receiving: 56643089 - CMS 15 Jan 1990 13:59:43 


HEKEKEKEKKKEREKEKEKEKEEREKRREREKEREKERERERERERREREREREKKKKEK 


LOADING 

DMSXA $APCALL G1 
DMSXA  $APC9C22 G1 
DMSXA $EXCALL Gi 
DMSXA  $EXC9C22 G1 


END-OF-FILE OR END-OF-TAPE 
LOADING... 

UM12603 $PTFPART U1 
END-OF-FILE OR END-OF-TAPE 
LOADING... 

DMSGLB = A39617DS U1 


Figure 24. Example of a VMFREC History File—$VMFREC $HISTORY 


The Load List 


The load list is an ordered listing of the CP, CMS, or GCS modules. The ordering (top to bottom) 
determines which modules come first on the system residence device and which modules come into storage 
upon an initial program load. 


The CP Load List 

For the CP load list, the order is determined by the HCPMDLAT MACRO, which is invoked by the 
HCPLDL ASSEMBLE module. The load list is created when HCPLDL is assembled. CPLOAD EXEC is 
shipped on the PUT service tape, but is not shipped on the COR tape. Therefore UTILITY must be used to 
generate the CPLOAD EXEC only if COR service is applied or if local modifications are made. 


The file created by assembling HCPLDL is called HCPLDL TEXT or HCPLDL TXTxxxxx. If it is called 
HCPLDL TXTnnnnn, you must rename it HCPLDL TEXT. You must then use the UTILITY EXEC to 
convert HCPLDL TEXT to CPLOAD EXEC. 

The modules fall into these general categories: 


¢ Resident modules. These modules are nonpageable. 


e Pageable modules loaded at initialization. These modules may not be paged until system initialization 
has finished. Thereafter, the modules can be paged out. . 


¢ Other pageable modules. These modules, along with the modules that are resident only during 
initialization, comprise the part of the system that CP pages in and out of real storage. 


The CP load list must have fixed-length 80-byte records. 

Do not change the CP load list unless it is absolutely necessary. 

The CMS Load List 

The CMS load list is called CMSLOAD EXEC. Do not change anything in the CMS load list except the 


SLC (Set Location Counter) cards, which point to files that determine where the modules in the CMS 
resident nucleus are loaded. 
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The GCS Load List 


The GCS load list is called GCSLOAD EXEC. Do not change anything in the GCS load list. 


The Temporary Load List 


The temporary load list is a file generated by VMFBLD. It includes all of the text decks in the original load 
list (CPLOAD EXEC for CP, CMSLOAD EXEC for CMS, GCSLOAD EXEC for GCS, etc.) as well as the 
filetype of the “latest” version of the text deck (latest being determined by the CNTRL and AUX file 
structure). HCPLDR MODULE generates the CP, CMS, and GCS nuclei using the temporary load list for 
each component. 


&TRACE OFF 

&1 &2 &3 HCPLDR LOADER 
&1 &2 &3 HCPSYS TXT12345 
&1 &2 &3 HCPRIO TXT22333 
&1 &2 &3 HCPDDI TXT98765 


&1 &2 &3 HCPMM3 TXT22333 


Figure 25. Example of a Temporary Load List —-$$$TLL$ EXEC 


The Load Map 


The load map has the same filename as the control file and a filetype of LOADMAP. It contains the map of 
CSECT external symbol resolution and service level information from the text decks, which are 
self-documenting. It is written to the A-disk if you specify the DISK option for the VMFBLD EXEC. 
Otherwise, it is spooled to the printer. | 


If the filetype of an update file listed in the load map begins with a percent sign (%), that update is listed in 
the control file and not in an auxiliary control file. 


Restart Indicator Files 


The VMFREC EXEC stores one or two restart indicator files on the alternate apply disk. Do not erase the 
restart indicator files. If you need to restart VMFREC, they determine how VMFREC will proceed. 
The restart indicator files are called: 
¢ For PUT service: 
prodid $MRPnnnn 
e For COR service: 


prodid 3MRCymdd 
$COR ymdd 


Where: 


prodid 
is the identifier of the product for which service is being received (for example, 56643089). 


nnnn 
is the PUT level. 
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ymdd 
is the date (last digit of year, month numbered in hexadecimal, day). 


If the $MRxxxxx file is present, the files for PUT level mmnn or COR service dated ymdd have been received 
and VMFREC has successfully completed. The MERGE disks will be merged from alternate to current 
when VMFREC is rerun for the same product or component. The components for which service has been 
received are listed in the SMRxxxxx file. 


SCOR ymdd contains the first record of the COR descriptor file, which contains the time when the tape was 


built. If this file is present for a tape you want to receive, it indicates that VMFREC has already been run 
for this tape. 


The Product Parameter File 


You must have a product parameter file in order to update products supported by the new service EXECs, 
including VM/XA System Product. The filename of the product parameter file is the product ID—for 
example, 56643089—and the filetype is SPPF. 


The product parameter file consists of a product area, one or more component areas, and one or more 
override areas. 


¢ The product area (introduced by the :COMPLST. tag) lists the components of the product. 
e Each component area (introduced by a :compname. tag) has three sections: 


— The first section (introduced by the :CNTRLOP. tag) contains control options such as the control file 
name, the system level and version, and the national language. 


— The second section (introduced by the :MDA. tag) contains minidisk assignments: 


— The TASK disks, where you can isolate the latest level of service EXECs 

— The LOCAL disks, where you keep local update files 

— The APPLY disk, where the auxiliary control structure will be built 

— The DELTA disks, where you will load the update files from the program update tape (PUT) 
— The BASE disks, holding the component’s source and object code 

— The BUILD disks, on which you will build your new system 

— The system’s minidisks 


— The third section (introduced by the :PRTFNC. tag) lists the EXECs needed to service each part of 
the component. There are three functional sections: 


— Receive (introduced by the :RECSER. tag) 
— Apply (introduced by the :APP. tag) 
— Build (introduced by the :BLD. tag) 


e Each override area (introduced by an :overname. tag) contains changes that can be made to the 
corresponding component area when the user wishes. The override area permits you to build several 
different.systems with a single product parameter file. 

A Sample Product Parameter File 


The listing below is a sample product parameter file. The tags are explained in “The Tags in the Product 
Parameter File” on page 395. 
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mmc ee eee 


—_—_ ce cc cr cmc mm Oe 


KEKE REE KEKEKEREEKREREREKRERAEREEREKRREREREREAKEERKKERERKKKKKIEE 


* COPYRIGHT - 5664-308 - (c) COPYRIGHT IBM CORP.- 1989 
* LICENSED MATERIAL - PROGRAM PROPERTY OF IBM 
* SEE COPYRIGHT INSTRUCTIONS, G120-2083 


KERREEREKEREEREKERKEEEKERKEKERREEEREREEREREREKEEEEEREREEEERREEEKREEEEREREEE 


+e ED De ee ry ee ee 8 ee 8 C8 ED OD ED 9 ee ee ee ee ee ee es 2 en es es ee nn en en es ee ee ee ee ee eee 
Sa a ae > AD Coed ee nt ae Ser Gee ema fe ee Ge ce ce se we ee ee et ee ee? ft Ct ee SD Gre ge ee es te ee ee ee ed oe et ee se se ee ee ce ee 


i Product Parameter File for VM/XA SP Release 2.1 


. Pe ee ee a ee Od Oe Ee ae ee ee ee ee 2 ee ee ee ee ee ee 0 ee ee ee ee ee et er ee ee ee ee eae 
a ee a eee Cee > ree eee Ca Cet dee ee ee QS ee ee ee ee DD EP ee ee  Cae ree Ce ee ee ee Se et et et et Ce eet © et ee Ge ae ee eee ean aeowew 


* 


* The following APAR's have been applied to this file: 


* 


APAR Date Description 


ees ae oe =) Oe eer cane GE eee eee = gD ee a ee ee ce 
Cenk Gere Oe Coe Se ee en ee ee es ce oe es ee me ae Ome OSD CENt Cent Camm teed eae Ow 8 OD 


aD SD oe a ee 
2 GE GS AED CERT TT HUD Se ei me Sete 


{] 
i] 
i] 
f] 
J 
{ 
| 
| 
| 
{] 
1 


* 
* 
* 
* 


* Se a a 8 ee OD ee EE A FP SS GS 0 rn re re rr 8 rn ee en 0 re eon en en eee oe eee 
SA eae ese eee ree ee ee ee ee Re ee ee ee Se a a a ae ee ee ee ee ae ce ree eed Cee dee ee re ee igs Se re a ee ed ee ed ee ee ee ee ee ee ee ee ee ed ee 


x NOTE: All tags must be in uppercase. 


te tr ee ae ee es ee en re on rt re rs ns es en ee ee ee ep ee ee ee os ee re ee ee en ee ee ee 0 ee ee ee ee ee ee ee ee ee eee 
ee es ae ee aed OD Geet Seed em dod Ge dee ed ee CUD Gerd ed Fem Se Se cage Se Soh DD GS SE SUN OU OEE SEE CUED one OED eres dram ee ere eed Se Se ee ee Ges Ge Ge ee ee eee ee > ow at © a a a ee eee 


Fe ee gt ce es ar DS ED SD GS DD PE PS EE Oe GD SITES VERDE OUD Cua OAM ODS SE OY OP RD SD SD SSG SE E.G PED SPUD GND Gerd = ery Ga tah lh QESSAGSD GAIUS SFR GE SEEPS GEES -P=D aE =D 
a a as ee ned ve ree ree eed Gee creed See PCa) Geet Cee Seed Se ee et ee a Se SE SS Ge ED GED CEES Come GED Coed CUS Game Comet eed CUED eed cet GE Se OD eS GD ED GED Ge pS ce Ge Ge SS Ge ce Gee dee Ce Geet Geen Gd Ge ee Sed Oo 


* Start of Product Header - List of Components in VM/XA SP Release 2.1 


* nee UP ee es ce ee ee ee ee ee rn rr rs ee ee es oe ce se ee ee ep ee ee ee em ee nt te se eo et OO ee ee ee eee ee 
et SS SS ae ee dey ee ee dee Gee eed eed dee ee: Gee Gee ee oe ee ee ee ee ee ee ee ee ee ee ee a ee ee ee ee es Ge ee es ee ee ee 2 ee ee ee a ee ee ee eee a ee et ee ee 


sCOMPLST. CP CMS DV GCS 
sOVERLSTP. 
sOVERLST. CORCP CORCMS CORDV CORGCS 


+ Oe ED NS a a a a es re Fe et OD Oe 2 ee es ee ee se re 0 ee eee eer eee 
a es ee red ree ear ced er eed Se Cee Cee Ree Se ee el ee a ee ee ee es ee ee ee ee ees ee ee ee es ce ee a ee en es en ee ee ee es ee ee ee ee ee et ee eee 


* End of Product Header 


a ce ie cre en eb Sassi saw Orn me im ce RS 0 0 OS ee ee ee ee ee ee ee ee ee es on es 2 ee es ee os ee oe ee ee ee en en ee se se ee ee eee 
amd Om SO Cec) Se Gm Se ee ce ce ee eM UD es Oe CS ED TD GD ae Gre SOP Ge? Pd Ge tered oe eed Amt a Cae ed cee Marcy SD OE EE GD me Cea Ge Gee Gre GED Gen) Cond coma! Gemp Gena ees SD OE SES SD GE OS EE Ca CD Ge Ca 


i a a ee rs as a kan es ae ah ce nk Oat da ie he te eed kc cg ch ec es cc es ie rd a ee se ee ee 
Re ae art Ce ae re ne fee See Se te ee Se Se ee ee ee ee re ee ee ee ee 9 ee re ee ee Oe OW om ee ort Se a © 6 es ee et ed 9 ee ee ee eet ae 


sCP. * Start of Parameters for CP 


* a ee Sw OD Gap CED ND OE Ci SD ED SERS PP ES DS ee ep es ce es ee ee ce ee ee re ee ee sn 0 ss rr re es a nn ne 8 eo te ee 
SS SS SD Ry OD aD ay a ve ae ee: ee Se eee ee ee ee ee ee ce ee Got re Ce oe dee Se ce ce Se ee Se et Oe ee Ge ee ee es es 0 ee ee et 


sCNTRLOP. * Section one - Control Options 

sas * DO NOT DELETE THESE CONTROL TAGS 
* TAG VALUE (S) * DESCRIPTION 

kk 

:CNTRL. HCPXA 
sUPDTID. | AUXXA 
:SLVI. A/HP A/PP 
sNLS. AMENG 
sUSEREXIT. VMFUECP 


kk 


Control Filename 

Update level identifier for building AUX 
System level and version indicators 
System Language 

User exit EXEC. Called before initial 
accesses and after final access retore. 

2 paramters passed will indicate calling 
EXEC and SET-UP or CLEAN-UP. 

Disk strings to be merged at Receive 
Erase lower level TEXT decks at Receive 
Check for full text at Apply 

:CKUPD. NO Check update fm regardless of $PTFPART fm 
:CKAUX. YES Check composite AUX at Build 

:CKREQ. YES * Check Requisites at Build 

Woeeoeer see reese sess sesssscssssscnsecsosesssscmscssssssscscoeessssess 
:MDA. * Section two - Mini-Disk Assignments 

a * STRING NAMES MUST START IN COLUMN 1 

* STRNGNAM MINIDISKS * DESCRIPTION 

kk 

TASK 5E5 

LOCAL1 295 

*LOCALn 

APPLY 492 291 292 
*APPLYn 


kk 
kk 


:MERGE. DELTA1 APPLY 
:LTO. NO 
:CKTXT. YES 


+ €¢ + ££ F&F SF SF HF FH FE HF HK F 


Build disks accessed before rest of dbase 
Disks for local service 

You may define additional LOCAL disks 
Control structure built by service execs 
You may define additional APPLY disks 


+ + + & 
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ecm erm meee enc ce ye cc wre ee ee ne aes ans mes = =m e—n—nn ss Ss eee  s se eee _s=Ss ee 


DELTA1 594 591 294 * CP service from TAPE 


*DELTAn * You may define additional DELTA disks 
BASE1 194 * CP text,loadlist,control file,maclibs 
BASE2 394 * CP source,macro defs,and copy files 
*BASEn * You may define additional BASE disks 
*BUILDI 423 * New SYSRES for CP Nucleus Build 

BUILD2 49D * New CMS system disk for AMENG HELP files 
BUILD3 49C * New CMS system disk for UCENG HELP files 
BUILD4 490 * New CMS system disk for nucleus etc. 
*BUILDn * You may define additional BUILD disks 
SYSTEM 191 * Disks reqd for your system environment 
*oncommecccsssemscoscememencsasmeeecoc rr oes eases sas 
sPRTFNC. * Section three - Part type/Function List 
*toocccmameSccSs Rocco SSEEEeMeeeSasSS ISSSorSncSSSSsSSsnscSS 
sRECSER. * Receive (Service) 


kk 


* TAPEFILE EXEC TARGET * DESCRIPTION 

kk 
AXLIST VMFRCAXL DELTAl * Apply and Exclude lists 
PARTLST VMFRCCOM DELTA1 PTF Parts Lists 
UPDT VMFRCUPD DELTA] Update files for CP ASSEMBLE source 
TEXT VMFRCTXT DELTA1 Text replacement modules for CP 

ae Text shells created on target disk 

=e Update shells created on APPLY disk 
MACAUX VMFRCAUX DELTA] AUX files for updates to non-ASSEM parts 
MACUPDT VMFRCUPD DELTAI] Update files for non-ASSEMBLE parts 
SOURCE VMFRCCOM DELTA1 New Source (assemble,macro,copy,$exec...) 
MACLIB VMFRCCOM DELTAI Maclibs are not replaced on the base 
EXEC VMFRCCOM DELTA1 Replacement parts and regenerated 

°- parts other than maclibs, text, modules 
HELP VMFRCCOM BUILD2 AMENG HELP files go directly to the 

** AMENG help Build disk 
HELP VMFRCUPP BUILD3 UCENG HELP files go directly to the 

sas UCENG help Build disk 
RESV *VMFRCCOM DELTAI1 Reserved parts 
CPMOD VMFRCCOM BUILD4 CP modules targeted for system disk 
PTFS VMFRCCOM DELTAI1 PTF numbered parts other than TXT 


sAPP. * Apply Function 


t+ * + © & SF SE SE Fe SF HF HF HF F HF HF HF F 


* PARTTYPE EXEC RENAME ™* DESCRIPTION 
* 


* 

TXT* VMFAPTXT TEXT 
ee 
ee 


Create AUX and rename appropriate update 
files to fm5 for names in loadlist. 
Other TXT parts renamed to TEXT 

TAM* VMFAPNLS TXTAMENG * For American English NLS support 

TKA* VMFAPNLS TXTKANJI * For KANJI NLS support 

TuUC* VMFAPNLS TXTUCENG * For Uppercase English NLS support 

TPO* VMFAPNLS TXTPORTG * For Brazilian Portuguese NLS support 
TFR* VMFAPNLS TXTFRANC * For French NLS support 


¢ + 


TGR* VMFAPNLS TXTGER * For German NLS support 
AUXXA VMFAPAUX * For MACRO and EXEC AUX files 
AXA* VMFAPAUX AUXXA * For MACRO and EXEC AUX files 
EXEC VMFAPCOM * 
MACRO VMFAPCOM - 
ahaa VMFAPCOM * ALL PARTS ARE LISTED BY FILETYPE 
mo. 4 VMFAPCOM * If a part type is not listed 
a2 2 - VMFAPCOM * VMFAPCOM is called by default 
Resco ee cccsssSs ssc rss rSSsScerSss rss sss sss Sse 
sBLD. * Build Function 
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OO a een ee ee 


ee ec ei ee 


ek 


* BUILDLST EXEC TARGET * DESCRIPTION 
ek 

Create CP nucleus based on loadlist 
Target disk symbol agrees with 

disk address in HCPSYS ASSEMBLE 

on the SYSRES macro. Defaults to 
what is in HCPSYS ASSEMBLE if no 
target disk is specified. 


CPLOAD VMFBDNUC *BUILD1 


+ 
* 
t+ + + & & 


CPYSYSCP VMFBDCPY BUILD4 * Copy TEXT decks that do not become 
x * part of a MODULE to the system disk 


* 
kk 


CPYBTHCP VMFBDCPY DELTAI1 Copy TEXT decks used by UTILITY and 
listed in the load list, CPLOAD EXEC, 
to the DELTA disk. VMFAPPLY only 
copies the ones not listed in the 


load list. 


* 
% 
+ + + & 


kx 
* CPYUTLCP VMFBDCPY DELTA1 
kk 
kk 


Copy TEXT decks used by UTILITY which 
are not listed in the load list, 
CPLOAD EXEC. This list would be used 
if you have local modifications and 
you choose not to run VMFAPPLY. Al] 


* 
* 
* 
kk * 
* 
ae * TEXT decks for which you have received 
* 
* 
¥e 
* 
* 


kk 


service and/or have local mods would 

be copied as a result. You need to remove 
the asterisk before CPYUTLCP before 
running VMFBLO. 

Use UTILITY to build CP Utilities 


*orrcscce srs sss sesso rer ssc ese rrssesssccmcmesesrsscscesssco 
: END. * End of Parameters for CP 
#ocecrrrcerrscrcsessr esc sso esse sesso sess scetcesssscccsessssece= 
Se ete pestas peta tented ata teetestertartee beter fenton tartestestententen teste terpefastestatertespeetartas tart ot testartan far ten parte tae pevter tartan tas tertertest tote t—tartattertment—t—) 
sCORCP. CP * Start of CP Corrective Service Overrides 


sMERGE. APPLYX DELTAX * Merge dummy APPLY and DELTA strings 

sMDA. UPDATE 

APPLYX 492 291 * Define dummy APPLY string 

DELTAX 594 591 * Define dummy DELTA string 
* During corrective service merges are per- 

we * formed based on these dummy strings. The 
* intermediate disks act as collectors for 
* corrective service until the next PUT. 


# ro S SSS SANS SI SSRI SSS SSS SASS SSIS Sa SSeS 
END. * End of CP Corrective Service Overrides | 
*scssosesssSsSsco sees esses cca escossmssscss 
*ooccsssseessosssccseesssrsssnesssssocceesssssssessssscscserscsssscocsessso 
:CMS. * Start of Parameters for CMS 
Socsccomersssssceemesssaccccsccesscssemeeeesceessssscommeees sss o———— 
sCNTRLOP. * Section one - Control Options 

pi * 00 NOT DELETE THESE CONTROL TAGS 

* TAG VALUE (S) * DESCRIPTION 

kk 

sCNTRL. DMSXA * Control Filename 

:UPDTID. | AUXXA * Update level identifier for building AUX 
sSLVI. A/DS E/DS * System level and version indicators 

:NLS. AMENG * System Language 


Chapter 8. Files Used in Service 


387 


emcee mec wr ms crm wr cc cc cc ec em oi 


sUSEREXIT. 


** 
xk 
kk 


sMERGE. 


VMFUECMS 


DELTAL APPLY 
NO 


* STRNGNAM MINIDISKS 


*k 


TASK 
LOCAL1 
*LOCALn 
APPLY 
*APPLYn 
DELTA1 
*DELTAn 
BASE1 
BASE2 
*BASEn 
BUILD1 
BUILD2 
BUILD3 
BUILD4 
*BUILDn 
SYSTEM 


*k 
ek 
kk 
** 


5E5 
395 


692 391 392 


593 691 293 


193 
393 


490 
49D 
501 
49C 


* 
* 
* 
* 


* 
* 
* 


+ +£ £ ££ £ F&F + F HF HF F F HF HF F 


191 295 594 591 294 


* 
* 
* 
* 


User exit EXEC. Called before initial 
accesses and after final access retore. 

2 paramters passed will indicate calling 
EXEC and SET-UP or CLEAN-UP. 

Disk strings to be merged at Receive 
Erase lower level TEXT decks at Receive 
Check for full text at Apply 

Check update fm regardless of $PTFPART fm 
Check composite AUX at Build 

Check Requisites at Build 


CEE, GON CHE ae: Ae ee Ea tet CD a a ee EE eh egy oa te OS See a te ee SD Ce 


Section two - Mini-Disk Assignments 
STRING NAMES MUST START IN COLUMN 1 
DESCRIPTION 


Build disks accessed before rest of dbase 
Disks for local service 

You may define additional LOCAL disks 
Control structure built by service execs 
You may define additional APPLY disks 
CMS service from TAPE 

You may define additional DELTA disks 
CMS text,loadlist,control file,maclibs 
CMS source and macro definitions 

You may define additional BASE disks 

New CMS system disk for nucleus etc. 

New CMS system disk for AMENG HELP files 
New CMS system disk for EREP files 

New CMS system disk for UCENG HELP files 
You may define additional BUILD disks 
194 

Disks reqd for your system environment. 
CP database needed for MACLIBs. If 
latest MACLIBs are on a build disk, only 
that disk must appear here. 


0 FP a FE Se EE Ee ES SS SD FENG ED CUTE Orb ity es Ged OD Se es a Sy DD es ee ey ee ee ey ee ee ee nO 0 ere ee Se ee SHR 8 eee 
ae ae ne ee es a ee Sei Meret ae Gio ee doe oe ee ee Oy Se Sd es Ge Coe eee feo ee ee fos oe Od Od ed es oe Gp fd Gee ted ce oe) Ga Oe et ee ee Oe to Ge Oo ed em Ge es es eo oe Oe ee 


¢PRTFNC. 


a a re ee gre cn gen 0 rn ems re ae a cs re OE PED Ot et ee eee m8 cen ce es PE Se gD ND SNS SD 


* 


Section three - Part type/Function List 


sRECSER. 


*&k 


* 


AXLIST 
PARTLST 
UPDT 
TEXT 


kk 
kk 


MACAUX 
MACUPDT 
SOURCE 
MACLIB 
EXEC 


kk 


MODULE 


kk 


HELP 


kk 


HELP 


kk 


* TAPEFILE EXEC TARGET 
* 


VMFRCAXL DELTAL 
VMFRCCOM DELTA1 
VMFRCUPD DELTA1 
VMFRCTXT DELTA1 


VMFRCAUX DELTA1 
VMFRCUPD DELTA1 
VMFRCCOM DELTA1 
VMFRCCOM BUILD1 
VMFRCCOM DELTA1 


VMFRCCOM BUILD1 
VMFRCCOM BUILD2 


VMFRCUPP BUILD4 
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* 


* 


* 


t+ + + ££ F F&F HF F SF HF HF FHF HF FHF KF HF F 


Receive (Service) 
DESCRIPTION 


Apply and Exclude lists 

PTF Parts Lists 

Update files for CMS ASSEMBLE source 
Text replacement modules for CMS 

Text shells created on target disk 
Update shells created on APPLY disk 

AUX files for updates to non-ASSEM parts 
Update files for non-ASSEMBLE parts 

New Source (assemble,macro, copy, $exec...) 
Maclibs go directly to the Build disk 
Replacement parts and regenerated 

parts other than maclibs, text, modules 
CMS/IOCP modules go directly to the 
Build disk 

AMENG HELP files go directly to the 
AMENG help Build disk 

UCENG HELP files go directly to the 
UCENG help Build disk 


IOCP files go to the DELTA1 disk 
Reserved parts 
ptf numbered parts other than TXT 


* 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


* 


Apply Function 


DESCRIPTION 

Create AUX and rename appropriate update 
files to fm5 for names in loadlist. 
Other TXT parts renamed to TEXT 

For American English NLS support 

For KANJI NLS support 

For Uppercase English NLS support 
For Brazilian Portuguese NLS support 
For French NLS support 

For German NLS support 

For EXEC AUX files 

For EXEC AUX files 

For MACRO AUX files 

For MACRO AUX files 

ALL PARTS ARE LISTED BY FILETYPE 


If a part type is not listed 
VMFAPCOM is called by default 


te a ey a ES DG FS OD ES EE PD LE DS SS a ee ee eh aS ED UD ED SD ES Ne ED ES SE 8 ES Oe rn ed A ey ee ee ee 
em Gad Ga Came Gree Cet See Gee a EE EC GC GE GD GS a TE TD CD SCE AP SS TS ES ND ES RD CAS AL GD GD GrUeD Ga Ge eh RT ED 


IOCP VMFRCTXT DELTA1 
RESV *VMFRCCOM DELTAI 
PTFS VMFRCCOM DELTA1 

sAPP. 

kk 

* PARTTYPE EXEC RENAME 

kk 
TXT* VMFAPTXT TEXT 

** 

*k* 
TAM* VMFAPNLS TXTAMENG 
TKA* VMFAPNLS TXTKANJI 
TUC* VMFAPNLS TXTUCENG 
TPO* VMFAPNLS TXTPORTG 
TFR* VMFAPNLS TXTFRANC 
TGR* VMFAPNLS TXTGER 
AUXXA VMFAPAUX 
AXA* VMFAPAUX AUXXA 
AUXMXA VMFAPAUX 
AXM* VMFAPAUX AUXMXA 
EXEC VMFAPCOM 
MACRO VMFAPCOM 

ice VMFAPCOM 

sk alae VMFAPCOM 

a VMFAPCOM 

BLD. 


kk 


* BUILDLST EXEC 


kk 


CMSLOAD VMFBDNUC BUILD1 
* 


TARGET 


* 
CPYSYSCM VMFBDCPY BUILD1 
kk 
kk 
CPYBTHCM VMFBDCPY DELTA1 
kk 
kk 
kk 
** 
kk 
* CPYGNDCM VMFBDCPY DELTA1 
Kk 
kk 
kk 
kk 
kk 
kk 


* 


* 


+ 


+ © + 4 F 


t+ + £ &€ ££ £ FH HF SF 


Build Function 
DESCRIPTION 
Create CMS nucleus based on loadlist 


Copy TEXT decks that do not become 
part of a MODULE to the system disk 


Copy TEXT decks used by CMSGEND and 
listed in the load list, CMSLOAD EXEC, 
to the DELTA disk. VMFAPPLY only 
copies the ones not listed in the load 
list. 


Copy TEXT decks used by CMSGEND which 
are not listed in the load list, 
CMSLOAD EXEC. This list would be used 
if you have local modifications and 
you choose not to run VMFAPPLY. All 
TEXT decks for which you have received 
service and/or have local mods would 
be copied as a result. You need to remove 
the asterisk before CPYGNDCM before 
running VMFBLD. 

Use CMSGEND to build CMS modules 


A PID ND ED 
SE A EE RS NA CD DS SD I eT a a A ES I ST A ED SD SD A A EE eS SS A ES CS RN OD A PED EE a SE ES 


0 8 EE SR EE PE SS SS SS ee A Se EE NY A SS EE TT i Py eS 
Sa ae ce see tee rt et he te en a eae ee a see SD Gee dee ee deed Gee Seed aD dee de Ge et ee eee eee ee ce ee dee Gee eed deed eh de Get ee ee a es de dt te 


Sh A cs cs ce cee ee see Cee een emt ee hh Spe ec ep a a cp ee a ce ee Gee Cee ee a de ee ee Coed Aa ee ee ee ed a ee ee ee es ce fee ee ed oe Et ge ee ed es ed 


sCORCMS. CMS 


* 


Start of CMS Corrective Service Overrides 


$e Ee FD ee ee OED ee my rer GS re ES FD nd 8 ee ee ee ee en en ee ee en ee eg ee ee ee ee ee ee oe ee ee ee 
fae Ca Ce Ge fede tee Geer end Gee ee Se eed ce ree a Fe a a ce ee ee Geet ee do eed deb dee Gm Ga Ge Ge Le ee ee Gee ee pa Se Se fo Ce SG Gee AN CD CD te ead eee ere oe ee ay i 
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qe wee cm ww ms ww cs cm cm cc cc cre er ee ee 


:MERGE. APPLYX DELTAX * Merge dummy APPLY and DELTA strings 
sMDA. UPDATE 
APPLYX 692 391 
DELTAX 593 691 


* Define dummy APPLY string 

* Define dummy DELTA string 

* During corrective service merges are per- 
= * formed based on these dummy strings. The 

* intermediate disks act as collectors for 

* corrective service until the next PUT. 


a OLE? GP oe Gee feet) So ed Qed Ge) dss ee ee et Re ee tere eed Gee ea a a GU, Oe EE ED Tae ee oe ee ne ie Ee ee eh God ton oe oe a GS a oe Ge ee a Gd GD dee to ee oe eS 


*cccsssssascrsrs sccm SsSssssesreseesssceeressssss 


:DV. * Start of Parameters for DV 

Sooo ssc cesses sccm ssscescssesccssSessssseessscsscsressssses 
:CNTRLOP. * Section one - Control Options 

os * DO NOT DELETE THESE CONTROL TAGS 

* TAG VALUE (S) * DESCRIPTION 


kk 


:CNTRL.  HCSXA 
:UPDTID.  AUXXA 
:SLVI. -A/HP_A/PP 
:NLS. AMENG 
sUSEREXIT. VMFUEDV 


**x 


* Control Filename 
* Update level identifier for building AUX 
* System level and version indicators 
* System Language 
* User exit EXEC. Called before initial 
* accesses and after final access retore. 
* 2 paramters passed will indicate calling 
= * EXEC and SET-UP or CLEAN-UP. 
sMERGE. DELTA1 APPLY * Disk strings to be merged at Receive 
* Erase lower level TEXT decks at Receive 
* Check for full text at Apply 
* Check update fm regardless of $PTFPART fm 
* Check composite AUX at Build 
* Check Requisites at Build 


sMDA. * Section two - Mini-Disk Assignments 

isis * STRING NAMES MUST START IN COLUMN 1 

* STRNGNAM MINIDISKS * DESCRIPTION 

kk 

TASK 5E5 * Build disks accessed before rest of dbase 
LOCAL1 395 * Disks for local service 

*LOCALn * You may define additional LOCAL disks 
APPLY 692 391 392 * Control structure built by service execs 
*APPLYn * You may define additional APPLY disks 
DELTA] 593 691 293 * DV service from TAPE 

*DELTAn * You may define additional DELTA disks 
BASE1 193 * DV text,loadlist,control file,maclibs 
*BASEn * You may define additional BASE disks 
BUILDi 490 * New system disk for CMS and Dump Viewer 
BUILD2 49D * New CMS system disk for AMENG HELP files 
BUILD4 49C * New CMS system disk for UCENG HELP files 
*BUILDn * You may define additional BUILD disks 
SYSTEM 191 295 594 591 294 194 

o * Disks reqd for your system environment. 
a * CP database needed for MACLIBs. If 

= * latest MACLIBs are on a build disk, only 
ek * 


that disk must appear here. 
Rosser SSS Sere esses SSeS 


:PRTFNC. * Section three - Part type/Function List 


Geeta es en rear nee eee perpen tae ont om teretenger ante anteantenstenrter ter pectefartertenrtarterter te eet eter tere ea epee — ttt on reed ape pe peer reed 
sRECSER. * Receive (Service) 
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kk 


* TAPEFILE EXEC TARGET 
kk 
AXLIST  VMFRCAXL DELTA1 
PARTLST VMFRCCOM DELTAL 
UPDT | VMFRCUPD DELTA1 
DVFTEXT VMFRCTXT DELTA1 


ek 


* 


DESCRIPTION 


Apply and Exclude lists 

PTF Parts Lists 

Update files for HCSTBL ASSEMBLE source 
Text replacement modules for DV 

Text shells created on target disk 
Update shells created on APPLY disk 

AUX files for updates to non-ASSEM parts 
XEDIT updates to DELTA disk 

(DVFXEDIT $XEDIT and FINDUSER $XEDIT) 
New Source (assemble,macro,copy,$exec...) 
DUMP VIEWING EXECs go directly 

to the Build disk 

includes CPBLOCK CBMAP and HCSCP1 TABLE 
DUMP VIEWING modules go directly 

to the Build disk 

AMENG HELP files go directly to the 
AMENG help Build disk 

UCENG HELP files go directly to the 
UCENG help Build disk 

Reserved parts 

ptf numbered parts other than TXT 


*** 


EXECAUX VMFRCAUX DELTA1 
EXECUPD VMFRCUPD DELTA1 
kk 
SOURCE VMFRCCOM DELTA1 
DVFEXEC VMFRCCOM BUILD1 


kk 
kk 


DVFMODS VMFRCCOM BUILD1 


kk 


HELP VMFRCCOM BUILD2 


kk 


HELP VMFRCUPP BUILD4 
*&xX 

RESV *VMFRCCOM DELTA1 

PTFS VMFRCCOM DELTA1 


+ ££ + + €¢ € € + + + & FE HF F HF F&F FF HF HF EF F 


sAPP. * Apply Function 


* PARTTYPE EXEC RENAME * DESCRIPTION 
kk 
TXT* VMFAPTXT TEXT * Create AUX and rename appropriate update 
sa * files to fm5 for names in loadlist. 
i * Other TXT parts renamed to TEXT 
TAM* VMFAPNLS TXTAMENG * For American English NLS support 
TKA* VMFAPNLS TXTKANJI * For KANJI NLS support 
TUC* VMFAPNLS TXTUCENG * For Uppercase English NLS support 
TPO* VMFAPNLS TXTPORTG * For Brazilian Portuguese NLS support 
TFR* VMFAPNLS TXTFRANC * For French NLS support 


TGR* VMFAPNLS TXTGER * For German NLS support 
AUXXA VMFAPAUX * For EXEC AUX files 
AXA* VMFAPAUX AUXXA * For EXEC AUX files 
EXEC VMFAPCOM * ) 
Te VMFAPCOM * ALL PARTS ARE LISTED BY FILETYPE 
ms VMFAPCOM * If a part type is not listed 
lee VMFAPCOM * VMFAPCOM is called by default 
*toecomsces mamas sae sss 
:BLD. * Build Function 


+ 


* BUILDLST EXEC TARGET 


kk 


CPYSYSDVY VMFBDCPY BUILD1 


*k 


DESCRIPTION 


* 


Copy DV Interface Files to System disk 


“* * Use UTILITY DVFGEND to build Dump Viewer 
*tonremcsscmcoesmmnssccoessmscoreeemenseeccnssesmsssoamesSoce 
END. * End of Parameters for DV 
Rkeccerescsssssccresssssssscscseersrscsccscscssterscs2sssssssssascr teres sccscscssssso 
Feeccscsssccecesesssscsccssessssscrrcscesctscesesrsssccssssscscsscmeesercscscsseresrssces 
sCORDV. DV * Start of DV Corrective Service Overrides 


* 0 ED FE ore cee a a ED ED OY EE A Se A eG EY FD FS ED EE PD RS TEE CG DD OD SUD -  Y E S  F E P  S D FD E  S 


a 
ee wee Gem Ee re a ee re a EO SD SE CE GES GE Gea RT a Ga ED ce GE A AD Ee DS ES CD CS GEE AD Ge eS Groh Go SD CO fe ee ee dels ey Sa a Ge CD ERS dar ora a Se ae Co 


:MERGE. APPLYX DELTAX * Merge dummy APPLY and DELTA strings 


Chapter 8. Files Used in Service 


391 


eee 
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:MDA. UPDATE 

APPLYX 692 391 * Define dummy APPLY string 

DELTAX 593 691 * Define dummy DELTA string 

ne * During corrective service merges are per- 
ba * formed based on these dummy strings. The 
ae * intermediate disks act as collectors for 

a * corrective service until the next PUT. 

Ba Fett Pe eta Pare eet Pa onan attest nn ran one erpentine tententantees ergs entantastenttert tert ertentantastestertertentestesartertertantesteststeetaxtertertertt=tarterterrertastt 
END * End of DV Corrective Service Overrides 

*nmmeccssae comes ese eres sss es 

*konccscssesscsmsemssersncsecemserssscere esc sense terse sssroes 
:GCS * Start of Parameters for GCS 
*earrccssosccsmecm sane sarcasm seers 
sCNTRLOP. * Section one - Control Options 

ae * DO NOT DELETE THESE CONTROL TAGS 

* TAG VALUE (S) * DESCRIPTION 

*k* 

:CNTRL. CSIXA * Control Filename 

sUPDTID. | AUXXA * Update level identifier for building AUX 
sSLVI. A/CI * System level and version indicators 

:NLS. AMENG * System Language 

sUSEREXIT. VMFUECMS * User exit EXEC. Called before initial 

sad * accesses and after final access retore. 

ied * 2 paramters passed will indicate calling 
ae * EXEC and SET-UP or CLEAN-UP. 

sMERGE. DELTAL APPLY * Disk strings to be merged at Receive 
:LTO. NO * Erase lower level TEXT decks at Receive 
sCKTXT YES * Check for full text at Apply 

:CKUPD NO * Check update fm regardless of $PTFPART fm 
:CKAUX. YES * Check composite AUX at Build 

:CKREQ YES * Check Requisites at Build 

k&sccmeccces comers ecstatic 
:MDA. * Section two - Mini-Disk Assignments 

on * STRING NAMES MUST START IN COLUMN 1 

* STRNGNAM MINIDISKS * DESCRIPTION 

#k 

TASK 5E5 * Build disks accessed before rest of dbase 
LOCAL1 495 * Disks for local service 

*LOCALn * You may define additional LOCAL disks 

APPLY 892 491 592 * Control structure built by service execs 
*APPLYn * You may define additional APPLY disks 

DELTA1 896 791 596 * GCS service from TAPE 

*DELTAn * You may define additional DELTA disks 
BASE1 595 * GCS text, loadlist,control file,maclibs 

oP * Nucleus, LOADLIB, EXECs 

*BASE2 * GCS source files ASSEMBLE,$EXEC,$XEDIT 

*BASEn * You may define additional BASE disks 

BUILD1 895 * New GCS system disk for nucleus etc. 
BUILD2 89E * New GCS system disk extension 

BUILD3. 49D * New CMS system disk for AMENG HELP files 

BUILD4 49C * New CMS system disk for UCENG HELP files 
BUILD5 490 * New CMS system disk for GCS Interface 
*BUILDn * You may define additional BUILD disks 

SYSTEM 191 * Disks reqd for your system environment. 
fSocm Saeco SIEM SSeS 
:PRTFNC. * Section three - Part type/Function List 

*kocer mses sss sess sess sss sees 
:RECSER. * Receive (Service) 

kk 
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* TAPEFILE EXEC 


** 


TARGET 


AXLIST VMFRCAXL DELTA 
PARTLST VMFRCCOM DELTA1 
TEXT VMFRCTXT DELTA] 
kk 
ek 
EXECAUX VMFRCAUX DELTA1 
EXECUPD VMFRCUPD DELTA 
SOURCE VMFRCCOM DELTA1 
MACLIB VMFRCCOM BUILD1 
EXEC VMFRCCOM DELTA1 
kk 
MODULE VMFRCCOM BUILD1 
HELP VMFRCCOM BUILD3 
kk 
HELP VMFRCUPP BUILD4 
kk 
RESV = *VMFRCCOM DELTA1 
PTFS VMFRCCOM DELTA1 
GCSCMS VMFRCTXT DELTA1 
kk 
k* 
sAPP. 
*k 
* PARTTYPE EXEC RENAME 
*k 
TXT* VMFAPTXT TEXT 
** 
kk 
TAM* VMFAPNLS TXTAMENG 
TKA* VMFAPNLS TXTKANJI 
TUC* VMFAPNLS TXTUCENG 
TPO* VMFAPNLS TXTPORTG 
TFR* VMFAPNLS TXTFRANC 
TGR* VMFAPNLS TXTGER 
AUXXA — VMFAPAUX 
AXA* VMFAPAUX AUXXA 
EXEC VMFAPCOM 
MACRO = VMFAPCOM 
we, VMFAPCOM 
ile VMFAPCOM 
“, VMFAPCOM 
* 
:BLD. 


kk 


* BUILDLST EXEC 


wk 
GCSLOAD VMFBDNUC BUILD1 
*k*k 
**k 
CPYGCS 
kk 
ak 
kk 
* CPYOTHGC VMFBDCPY DELTA1 
kk 
kk 


TARGET 


VMFBDCPY BUILD5 


*k 


* 


+ 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


* 
* 


* 


DESCRIPTION 


Apply and Exclude lists 

PTF Parts Lists 

Text replacement modules for GCS 

Text shells created on target disk 
Update shells created on APPLY disk 

AUX files for updates to non-ASSEM parts 
Update files for non-ASSEMBLE parts 

NEW SOURCE FILES GO ON DELTAI 

Maclibs go directly to the Build disk 
Replacement parts and regenerated 

parts other than maclibs, text, modules 
GCS modules go directly to the Build disk 
AMENG HELP files go directly to the 
AMENG help Build disk 

UCENG HELP files go directly to the 
UCENG help Build disk 

Reserved parts 

PTF numbered parts other than TXT 

Text replacement GCS interface files. 
Text shells created on target disk 
Update shells created on APPLY disk 


Apply Function 
DESCRIPTION 


Create AUX and rename appropriate update 
files to fm5 for names in loadlist. 
Other TXT parts renamed to TEXT 

For American English NLS support 

For KANJI NLS support 

For Uppercase English NLS support 
For Brazilian Portuguese NLS support 
For French NLS support 

For German NLS support 

For MACRO and EXEC AUX files 

For MACRO and EXEC AUX files 


ALL PARTS ARE LISTED BY FILETYPE 
If a part type is not listed 
VMFAPCOM is called by default 


pF SS TS ee i SS PS Se TS ES NS ES ED SP TTD UD ME Ee FT PD ED SD EY AUD ene PND HY ED DS CD GS STEN a es ey ee ED SE GI NY ED a, 
os a AS eS a ae See Gone Cad ED Ga ea a A GE RY GED CD ED PD GD Ga GAD GD Ga a hE ED CD A CE OE RD Po a CD ESS ENED EES CS a ED a EE GG ie ee ee ee 


Build Function 


DESCRIPTION 


* Create GCS NUCLEUS based on LOADLIST 


+ 


t+ + + 


Use GROUP EXEC to build GCS Macilbs 


Rename/Copy GCS Interface Files, needed 
for DUMPSCAN formatters, these are 
TEXT decks. 


PMX modules or TEXT decks, message 
exchangers, loaded in SNA program 
products, that do not become part of 
the GCS nucleus. If you choose not 
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— eee ee ieee ee eee 


we * to run VMFAPPLY, this list would 


ve * copy these text decks to the 

oy * DELTA disk during the VMFBLD process. 
*secscemeosscerccssccceseescossersscsccescssscscsmerssssssresssseceresssscsss 
sEND. * End of Parameters for GCS 
*tomcmoscccsammeonnmsomssamansrsisaome assesses 
toccnemmescccsamsee coarseness esis 
sCORGCS. GCS * Start of GCS Corrective Service Overrides 
teccomercocscoooosses= ae Seat Sd Sed a aE nee SaaS SES Sed Gea ms SD SG ND SD ANS SS SSD Ome Se SS Sev SO Sal OS Se ED RN a ceva es ee ee SO 
sMERGE. APPLYX DELTAX * Merge dummy APPLY and DELTA strings 

:MDA. UPDATE 

APPLYX 892 491 * Define dummy APPLY string 

DELTAX 896 791 * Define dummy DELTA string 

si * During corrective service merges are per- 
ad * formed based on these dummy strings. The 
= * intermediate disks act as collectors for 
=e * corrective service until the next PUT. 
k&meoememmccssceres ccs somes essere sscsccssssceeemsssmcsrersesseccessses 
sEND * End of GCS Corrective Service Overrides 


ee Gee aed ae Cam Ce ee Gas it Ged Co Co mt eee ee ee Ce dee ay CP ee Ee EE Gd GD om a ew Se ed Gee ee ed ee Ged ee Se Ge ee Sp ee ce CG ee Oe 


Warning: The disk addresses in the SPLOAD PROFILE, the user directory, 56643089 $PPF, and the 
SETUP EXEC must all match the default addresses the ITASK EXEC uses. If you change an address in any 
one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


394 Installation and Service 


The Tags in the Product Parameter File 


Product Area 


;COMPLST. compnamel compname2 ... compnamen comment 


:;COMPLST. 


is a list of the components in the product. It can be specified only in the product area of the base 
product parameter file (where it is required), not in an override file. 


compname 
is an unofficial nickname, in uppercase, for the component. The first component of the product on 
the PUT gets the first compname in the list, the second component the second compname:and so on. 


comment 


is any string prefixed with an asterisk. A comment can appear after any of the tags or on a line by 
itself anywhere in the product parameter file. 


;OVERLSTP. overnamel overname?2 ... overnamen 
is a list of override names that you want VMFOVER to prompt you with, in addition to the list of 
component names following the :COMPLST. tag, if VMFOVER is invoked without a component being 


specified. If you do not want VMFOVER to prompt you with any override names, specify :OVERLSTP. 
followed by an empty list. 


If you do not specify the :OVERLSTP. tag, the names following the :OVERLST. tag are used for 
prompting. You do not have to list the override names twice. You will be prompted only once for any 
name listed on both tags. 


The :OVERLSTP. tag is required in the product area of the base product parameter file and permitted in 
the product area of a separate override file. It is not allowed in the component override section of either 
file. 


:OVERLSTP. must always be placed between the :COMPLST. tag and the :OVERLST. tag in the PPF. 


:OVERLST. overnamel overname2 ... overnamen 


is a list of override tags, each one related to a specific component. Several override tags can relate to the 
same component, but each override tag can only relate to one component. 


If you do not specify the :OVERLSTP. tag, the names following the :OVERLST. tag are used for 
prompting. You do not have to list the override names twice. You will be prompted only once for any 
name listed on both tags. 


The :OVERLST. specification is required in the product area of both the base product parameter file and 
the separate override file. It is not allowed in the component override section of either file. 


:OVERLST. must always be placed after the :OVERLSTP. tag in the base PPF. 


Component Area 


scompname. 


is an uppercase delimiter for the part of the PPF describing the component named. compname is one of 
the components named in :COMPLST. The end of the component part of the PPF for this component ts 
delimited by a corresponding :END. tag. 
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Control Options 


:<CNTRLOP. | 
is the delimiter for the component section of the PPF defining general parameters for the component. 


:CNTRL. control_file_name 
is the filename of the control file to be used to service, assemble, and/or build this component of the 
product. 


:SLVI. pl/ssl p2/ss2 ... pn/ssn 


‘SSLVI 
is a list of the system level and version indicators used as a prefix and suffix, concatenated with the 
numeric portion of the APAR number, to form the filetype of the update file. 


piss 
is a word that consists of two values separated by a slash. The first value, represented by a p, is the 
single character prefix in the update file filetype. The second value, represented by ss, 1s the 
2-character suffix in the update file filetype. 


:NLS. langid 
is specified to be one of the following: AMENG, KANJI, UCENG, PORTG, FRANC, or GER. For 
CP and CMS the default is AMENG. 


:-LTO. YES|NO 


sLTO. 
The Last Text Only option erases lower level text decks during receive. Duplicate text decks are 
never created, regardless of the setting of the LTO option (yes or no). 


YES 
indicates that during VMFREC a search is made for other text decks with the same filename and 
filetype prefix in the target minidisk string. If other decks exist, the PTF information in each text 
deck prologue is checked and only the latest text deck, including the one just read in, is kept on the 
DELTA disk. The other levels are replaced with text deck shells. The latest text deck includes the 
accumulation of all service in the decks being replaced. If this is not the case an error is included in 
the receive exception log. This requires write access to all DELTA disks on which text decks may 
exist. 


NO 
indicates that existing text decks for different PTFs are left as they are. If a text deck exists for the 
same PTF the new one is not kept. 


:;CKTXT. YES|NO 


;CKTXT. 
Check for full text at apply. The value of this tag may be overridden by using the CHECK or 
NOCHECK option on VMFAPPLY. CHECK is equivalent to :CKTXT. YES. NOCHECK is 
equivalent to :CKTXT. NO. 


YES 
indicates that when VMFAPPLY is complete, if a PTF which has been applied is a text shell and not 
a full text deck including executable code, an error should be placed in the Apply Exception Log. 


NO 
indicates that the application of a PTF which is a text shell will not cause an error in the exception 
log. 
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:;CKUPD. YES|NO 


:<CKUPD. 
Check and apply PTF's whether or not they have already been applied. A filemode of 5 on the 
$PTFPART list indicates that a PTF has been applied. 


YES 
indicates that a filemode of 5 on a $PTFPART list is not sufficient to prevent a PTF from being 
applied. Additional processing is performed for each part in the list. This makes it possible for the 
same PTF to be processed more than once. 


NO 
indicates that filemode 5 on the $PTFPART list will prevent the same PTF from being processed 
more than once. If the PTF has already been successfully applied as indicated by its filemode all 
further processing for this PTF is bypassed. 


:;>CKAUX. YES|NO 


;CKAUX. 
Check composite AUX at build. The value of this tag may be overriden by using the CHECK or 
NOCHECK option on VMFBLD. CHECK is equivalent to :CKAUX. YES and NOCHECK is 
equivalent to :CKAUX. NO. 


YES 
indicates that all AUX and update entries in the text deck should be verified against the AUX 
control structure ta be sure the correct deck has been located. 


NO 
indicates that only the entries in the AUX file used to locate the text deck will be verified against the 
text deck prolog. Additional entries in the text deck prolog are not verified for faster completion of 
the build process. 


:><CKREQ. YES|NO 


:;CKREQ. 
Check requisites at build. The value of this tag may be overridden by using the CHECK or 
NOCHECK option on VMFBLD. CHECK is equivalent to :CKREQ. YES and NOCHECK is 
equivalent to :CKREQ. NO. 


YES 
indicates that requisite information chains will be verified to assure that all required PTFs related to 
the ones applied are included in the system being built. The update files contain entries for 
PREREQ, CO-REQ and IF-REQ. 


PREREQs and CO-REQs describe dependencies in the same product. If the dependency is in the 
same component, the 7-character APAR number is listed (for example, VM12345). If the 
dependency is in another component of the same product the APAR number and component ID are 
included in parentheses following the PTF number, for example, UV54321(VM12345-56630130). 


If the dependency is in another product, an IF-REQ is used. An IF-REQ contains a PTF number 
rather than an APAR number. The APAR number and component ID are included in parentheses 
following the PTF number, for example, UV54321(VM12345-56630130). 


NO 
indicates that requisite information chains as contained in the text will not be verified during the 
VMFBLD EXEC. 


SUPDTID. updateid 

identifies the filetype of an AUX file and should match a filetype listed in the control file. This is the 
level at which AUX files will be updated or created as PTFs are applied. This updateid will be used 
unless you override it by providing an updateid as an argument to VMFAPPLY. 
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:USEREXIT. exitname 


sUSEREXIT. 
identifies the user EXEC for setup and cleanup to be called at beginning and end of each service 
function (VMFREC, VMFAPPLY, and so on). | 


exitname 
is the name of the user EXEC to be called. The first parameter is the uppercase name of the 
invoking EXEC. The second parameter is either SET-UP or CLEAN-UP, indicating initialization or 
termination. At termination the third parameter is the return code as determined by the invoking 
EXEC. The return code can be changed by the exit. Functions such as link and detach can be 
invoked by the exit. VMFUECP, VMFUECMS, and VMFUEDYV are the default exits provided by 
IBM. These exits are no-ops. 


:MERGE. symboll symbol2 ... symboin 


sMERGE. | 
is a list of symbolic disk strings (for example DELTA, APPLY) to be merged by VMFREC when the 
product or component being received already exists on the receive target disk. If the target disk does 
not contain the product or component being received, the merge does not take place. 


VMFREC accomplishes the merge by moving the contents of the disk before the last in the string to 
the last disk in the string, then erasing the disk before the last. It repeats this process with the next 
pair of disks, moving one disk to the left in the string each time, until the first disk in the string 1s 
clear. 


Note: If you want to prevent merging from taking place, see Appendix G, “Controlling Disk String 
Merges” on page 861. 


symbol 
is the symbolic name of a minidisk string such as DELTA], APPLY, or LOCALI. If the product or 
component is present, as indicated in a file with the filetype SMRxxxxx, on the first disk in any disk 
string in the list, all disk strings in the list are merged. 


Minidisk Assignments: 


Usage Notes: 
¢ Considerations for read-only disks in the product parameter file: 


Disks appearing in the MDA section of the $PPF may be specified as read-only by coding a slash (/) 
immediately following the disk address in the symbolic disk string. For example: 


DELTA 594 291 294/ 
indicates that the 294 disk is to be read-only and it will be accessed as mode/mode by VMFSETUP. 
¢ The first specification wins: 


If the disk address appears in a given section (receive, apply, and so on) more than once, its first 
specification determines its access status. 


e¢ Disks currently accessed R/W: 


If a disk is currently accessed R/W it is released and then accessed mode/mode. Upon performing a 
VMFSETUP restore it will once again be R/W. 


If the disk is R/W and empty (no CMS files on it) the mode/mode fails and a message is issued when the 
using application program attempts to access it. 


© Merge considerations: 


Do not use read-only disks in symbolic disk strings identified as strings to be merged. Merging requires 
write access. 
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:MDA. 
is an uppercase delimiter for the section describing the minidisk assignments. 


TASK ddddI dddd2 ... ddddn 


TASK 
lists the service EXECs build disk. The TASK disk is accessed after the A-disk and before the 
component data base disks. For more information on using the TASK statement to set up a separate 
disk for the service EXECs, see the “Usage Notes” section of the VMFREC EXEC description (on 
page /USAGE/). The symbolic disk name TASK must start in column 1. 


dddd 
is the 4-digit disk address of a system minidisk. 


SYSTEM dddd1I dddd2 ... ddddn 


SYSTEM 
lists the disks required for your working system environment. The symbolic disk name SYSTEM 
must start in column |. 


dddd 
is the 4-digit disk address of a system minidisk. 


BASEn dddd 


BASE] ... BASEn 
are the BASE disks created at installation time. You may define additional BASE disks if you have 
specific needs. The symbolic disk name BASE must start in column !. 


dddd 
is the 4-digit disk address of a BASE minidisk. 


DELTAn ddddl dddd2 ... ddddn 


DELTAI1 ... DELTAn 
are disks containing service from the PUT. You may define additional DELTA disks. The symbolic 
disk name DELTA must start in column 1. 


dddd 
is the 4-digit disk address of a DELTA minidisk. 


APPLYn ddddl dddd2 ... ddddn 


APPLY! ... APPLYn 
identifies the control structure to be built. AUX files and update shells are created on the APPLY 
minidisks. There is only one symbolic string of APPLY minidisks. The symbolic disk name APPLY 
must start in column 1. 


dddd 
is the 4-digit disk address of an APPLY minidisk. 


LOCALn dddd1 dddd2 ... ddddn 


LOCALI ... LOCALn 
are disks for local service and COR service. You may define additional LOCAL disks The symbolic 
disk name LOCAL must start in column 1. 


dddd 
is the 4-digit disk address of a LOCAL minidisk. 


BUILDn dddd 


BUILD!1 ... BUILDn 
are the new system residence disks for CP nucleus build. You may define additional BUILD disks. 
The symbolic disk name BUILD must start in column 1. 
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Warning: The -BUILD1. tag does not force the nucleus to be built on the specified disk. Make sure 
that the HCPSYS ASSEMBLE file (for CP), the DMSNGP profile (for CMS), or the saved system 
information panel (GRP121, for GCS), indicates the disk where you want to build the nucleus. 

dddd 
is the 4-digit disk address of a BUILD minidisk. 


EXECs 


:PRTFNC. 
is an uppercase delimiter for the section describing the list of the types of parts serviced with the 
functional EXEC assignments and symbolic target disk assignments. 

sRECSER. 


is an uppercase delimiter for the list of functional assignments related to the Receive function (VMFREC 
EXEC). This tag is followed by a list which contains one entry for each possible tape file for the 
component on the PUT or COR service tape. 


Each tape file contains all the parts of the same or a related type. The attribute that binds the types of 
part in a particular tape file is that they all require the same Receive processing and target minidisk 
symbol. Each part is in a separate CMS file within the tape file. 


tapfil execname target 


tapfil 
is an uppercase mnemonic that symbolizes the content of the tape file it represents. This is the first 
symbol in each entry for each tape file on the PUT or COR service tape. This symbol may start in 
any column. 


execname 


is the name of the EXEC that processes the types of parts found in the tape file represented by this 
entry. IBM provides four part handlers for the Receive function. VMFRCUPD processes update 
files. VMFRCTXT processes text decks). VMFRCAXL processes apply and exclude lists. 
VMFRCCOM processes all other parts by simply putting them to the target disk. 


An EXEC name starting with an asterisk causes the associated tape file not to be received. 
target 
is an uppercase symbol corresponding to the minidisk assignment section of the PPF that identifies 
where the parts are to be placed as they are received from the PUT. 
sAPP. 
is an uppercase delimiter for the list of functional assignments related to the apply function 
(VMFAPPLY EXEC). This tag is followed by a list which contains one entry for each type of part for 
the component. 
partype execname rename 


partype 
is an uppercase part filetype or part filetype prefix when terminated by an asterisk. If the partype 
symbol is TXT*, all parts with a filetype starting with the characters TXT are processed by the part 
handler name in this entry. If the symbol is MACRO, all parts with the filetype MACRO are 
processed by the part handler name in this entry. This symbol may start in any column. 


execname 


is the name of the EXEC that processes the types of parts found with the filetype represented in this 
entry. Parts with a filetype for which no partype symbol appears in the list will be processed by the 
common part type handler VMFAPCOM. Two other part handlers are provided by IBM for the 
Apply function. VMFAPTXT processes text decks, VMFAPNLS language versions of text decks. 
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rename 
is the new filetype to be given to those parts found to have an existing filetype matching the partype 
symbol in the entry, but not supported by VMFBLD. Parts supported by VMFBLD are not 
renamed. Whether parts are supported is determined by finding the part in the build list. Parts in 
the build list are located by PTF number. Parts not found in the build list are copied with a new 
filetype of rename. 


sBLD. 
is an uppercase delimiter for the list of functional assignments related to the build function (WMFBLD 
EXEC). This tag is followed by a list which contains one entry for each type of part which is built from 
a collection of other parts in the component. This symbol may start in any column. 


bldlst execname target 


bldlst 


is an uppercase filename for the list (build list) of parts to be included in the part being built. Fora 
nucleus this is a load list. 


execname 
is the filename of the EXEC that processes the build list. 


target 
is the symbolic name corresponding to the minidisk assignment section of the PPF that identifies 
where the part being built is to be placed. The minidisk address assigned to the symbol specified 
here should match the SYSRES address specified on the SYSRES macro in the HCPSYS file. 


SEND. 
identifies the end of the current component part. The next component in the PPF starts with the next 
:compname. from the :COMPLST. tag. 


Override Area 
:overname. compname ppfname [NEWNAME | OLDNAME] 


sovername. 
identifies the beginning of the override section for a component. This statement does not appear in 
the temporary PPF. 


compname 
is the name of the component specified in the base PPF :COMPLST. that is to be overridden. 


ppfname 
is the name of the PPF that is to be overridden. If ppfname is not specified, overname and compname 
must be in the same file (that is, the component override is part of the base PPF). 


NEWNAME 
indicates that the filename of the temporary PPF should be the filename of the override file. This 
option cannot be used in the override section of the base PPF (that is, when override and base PPF 
are in the same file). This option cannot be used during VMFREC. 


OLDNAME 
indicates that the filename of the temporary PPF should be the original filename of the base PPF file. 
OLDNAME is the default if neither OL.DNAME or NEWNAME is specified. 


:MDA. [REPLACE | UPDATE] 
:RECSER. [REPLACE | UPDATE] 
:APP, [REPLACE | UPDATE] 
:BLD. [REPLACE | UPDATE] 


:MDA. 
introduces the overrides for the minidisk assignment section of the component area. 
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:RECSER. 
introduces the overrides for the list of functional assignments related to the receive function 
(VMFREC EXEC). 

:APP. 
introduces the overrides for the list of functional assignments related to the Apply function 
(VMFAPPLY EXEC). 


:BLD. 
introduces the overrides for the list of functional assignments related to the build function 
(VMFBLD EXEC). 


UPDATE . 
indicates that the entries following the tag in the override section will overlay the corresponding entry 
in the base PPF. Any overlaid entry appears as a comment in the temporary PPF. If the entry does 
not exist in the base, the entry will be added at the end of the section in the base PPF. UPDATE is 
the default if neither UPDATE or REPLACE is specified. 


REPLACE 
indicates that all entries in the base PPF are to be removed and replaced by the entries in the 
override PPF. The removed entries do not appear as comments in the temporary PPF. 


Comments or a group of comments beginning with a single asterisk are merged into the temporary PPF 
immediately preceding the next non-comment statement. 


kk 


Comments or a group of comments beginning with a double asterisk are merged into the temporary PPF 
immediately following the previous non-comment statement. 


hit 
Comments beginning with three asterisks do not appear in the temporary override file. 
kek 


Comments beginning with more than three asterisks are handled as if they began with one asterisk. 


The Product Parameter Override File 


The product parameter override file is a separate file containing tags that you want to override the tags in the 
base product parameter file when you build or service your system. The override file permits you to create a 
new version of the product without creating a complete new product parameter file. 


The only difference between a separate override file and the override section of a base PPF is that the 
separate override file begins with an optional :OVERLSTP. tag and an :OVERLST. tag. In a base PPF, 
these tags come immediately after the :COMPLST. tag at the beginning of the file, not in the override 
section. 


The filename of the override file is the name of the new version of the product. The filetype is $PPF. 
The following example shows the override file used with the base file 56643089 $PPF to create an alternate 


product identifier (or “alias”) for VM/XA SP. Since the alternate product identifier is VMXA, the override 
file is called VMXA $SPPF. 


Note: If you want to invoke any overrides from the override section of the base product parameter file, for 
example, the COR service overrides, you must copy them to the separate override file. 


Save override files on the CMS alternate LOCAL1 (395) disk. IBM suggests that you should also 
save the updated product parameter file there. 


Figure 26 is an example of a product parameter override file. 
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* This is the alias override for the VM/XA Product 56643089 
sOVERLST. CP CMS DV GCS 

*** The overlst statement will not appear on the temporary composite 
*** product parameter file. 


:CP. CP 56643089 * Get the base unmodified PPF from the CP 
wee * file named 56643089 $PPF 
sEND. * End of current component section 
CMS. CMS 56643089 * Get the base unmodified PPF from the CMS 
wee * file named 56643089 $PPF 
sEND. * End of current component section 
:DV. DV 56643089 * Get the base unmodified PPF from the DVF 
wae * file named 56643089 $PPF 
: END. * End of current component section 
:GCS. GCS 56643089 * Get the base unmodified PPF from the CMS 
wee * file named 56643089 $PPF 

* 


sEND. End of current component section 


Figure 26. Example of a Product Parameter Override File (VMXA $PPF) 


The Temporary Product Parameter File 


VMFREC, VMFAPPLY, VMFHASM, VMFASM, VMFSETUP, VMFNLS, and VMFBLD all invoke the 
VMFOVER EXEC to create the temporary product parameter file from the product parameter file and 
sometimes the product parameter override file. The temporary product parameter file is a copy of the 
product area and one component area of the base product parameter file, with the tags from the override 
section or override file substituted where appropriate. If you specify the UPDATE option (the default) in the 
overrides, the overridden tags are included in the temporary PPF as comments. If you specify the REPLACE 
option, the overridden tags are not included. All the installation and service EXECs use this copy instead of 
the base PPF. 


If you use a separate override file and specify the NEWNAME option on the :compname. tag in the override 
file the filename of the copy is the filename of the override file. Otherwise, it is the filename of the base PPF. 
The filetype of the copy is SPPFTEMP. 


To see the temporary product parameter file before you run a service EXEC, invoke VMFOVER from the 
command line. You can also examine the temporary product parameter file after running the service EXECs. 
It is not erased. 


Many different temporary product parameter files can be created from the base file on page 384, 56643089 
$PPF. In the simplest example, if you issue this command: 
vinfover 56643689 cp a 


you will get a temporary file just like the CP section of the base file, like the file in Figure 27 on page 404. 
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* Temporary override of CP component 
* in PPF of product 56643089 

* by CP override section 

* of the PPF for the product 56643089 


MERCK ERERRERERREEREEREREEERERERREEEEEREREREREREREEKRERREEREKRE 


* COPYRIGHT - 5664-308 - (c) COPYRIGHT IBM CORP.- 1989 
x LICENSED MATERIAL - PROGRAM PROPERTY OF IBM 
- SEE COPYRIGHT INSTRUCTIONS, 6120-2083 


KERKEKREKRKEEKRERRERERERERKEREREEREEREEREEREREREREREREEREEREEEEEEEEEREEEREREEE 


* nr ee ee en es ee eee OSS Se Se ee eS ee See ES ES NY OS LL LY NY NG LY PLS ASP SPL ND SD $s ES OP OP Gn See GES GED ED 
SS SED CREF SEAS GE Ga Ce Gene toe Seed Gem ted Gee cad tome SE SE SE SS PND AD Soul Ga Gand daw Samed tamed Seed Gea Gea} Cub tem Gud Ga Ce Ce SD SE EE SORE SEN eS Gey Samed Cand wah Gee Sl OS a See Coe eee ee Com Cera CoD 


Product Parameter File for VM/XA SP Release 2.1 


Figure 27 (Part 1 of 4). 56643089 $PPFTEMP (without Overrides) 
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:COMPLST. cP CMS DV GCS 
sOVERLSTP. 
sOVERLST. 


* 2 SS AS A OD IPD NP GR ED Se ey Ce De PR DS co ret er ee oe ee ge ee ee et ee 
fen Gerd Ged Gee a De es Oe ah Ged ded ee ee sc de ee ee ee ge ee GQ eh Se a ee ee ded ee Oe eed ee eee Ce es 


* End of Product Header 


* ED 6 CD ee ee re ee rk 2 re 8 ee en ee ee re er ee 8 ee eee. 


kscosscccansecesssscssssssscsceeesssssssssascrrssscsssssecmstssesscsscseres= 
sCP, * Start of Parameters for CP 

*-=== ae a a de ae ae ee es ee ee a Sed es Sew ee ee me me See See ee me Sm Sn SDS Gove AD Sa mee eee A SD Se OD eee SD See oa ee eee Se See Se ee Oe aE oe 
:CNTRLOP. * Section one - Control Options 

ies * DO NOT DELETE THESE CONTROL TAGS 

* TAG VALUE(S) * DESCRIPTION 

kek 

sCNTRL. HCPXA * Control Filename 

sUPDTID. | AUXXA * Update level identifier for building AUX 
sSLVI. A/HP A/PP * System level and version indicators 

:NLS. AMENG * System Language 

sUSEREXIT. VMFUECP * User exit EXEC. Called before initial 

= * accesses and after final access retore. 
a * 2 paramters passed will indicate calling 
- * EXEC and SET-UP or CLEAN-UP. 

MERGE DELTAl APPLY * Disk strings to be merged at Receive 
:LTO. NO * Erase lower level TEXT decks at Receive 
sCKTXT YES * Check for full text at Apply 

sCKUPD NO * Check update fm regardless of $PTFPART fm 
: CKAUX YES * Check composite AUX at Build 

:CKREQ YES * Check Requisites at Build 
Rksccorersrssssscrcereersessssssaccesee sess ssssssssssccs22sessssceees 
sMDA. * Section two - Mini-Disk Assignments 

¥* * STRING NAMES MUST START IN COLUMN 1 

* STRNGNAM MINIDISKS * DESCRIPTION 

** 

TASK 5E5 * Build disks accessed before rest of dbase 
LOCAL1 295 * Disks for local service 

*LOCALNn * You may define additional LOCAL disks 
APPLY 492 291 292 * Control structure built by service execs 
*APPLYn * You may define additional APPLY disks 
DELTA1 594 591 294 * CP service from TAPE 

*DELTAn * You may define additional DELTA disks 
BASE1 194 * CP text,loadlist,control file,maclibs 
BASE2 394 * CP source,macro defs,and copy files 
*BASEn * You may define additional BASE disks 
*BUILDI 423 * New SYSRES for CP Nucleus Build 

BUILD2 49D * New CMS system disk for AMENG HELP files 
BUILD3 49C * New CMS system disk for UCENG HELP files 
BUILD4 490 * New CMS system disk for nucleus etc. 


Figure 27 (Part 2 of 4). 56643089 SPPFTEMP (without Overrides) 
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*BUILDn * You may define additional BUILD disks 


SYSTEM 191 * Disks reqd for your system environment 
*koeoccmcmsessessecencssarsseesssssssasssasmasssssesssesssssssessssszss 
sPRTFNC. * Section three - Part type/Function List 
tor a ee ee rs a a a a se ee a ae ce ee DS a ee SS ae eh aS ee Sm Se Se Se aD Se Se SD SE SS SD SD SE SD Oe SO See See So Sd On Oe ee ee ee 
sRECSER. * Receive (Service) 


kx 


* TAPEFILE EXEC TARGET * DESCRIPTION 
k* 
AXLIST VMFRCAXL DELTA1 ™* Apply and Exclude lists 
PARTLST VMFRCCOM DELTA] PTF Parts Lists 
UPDT VMFRCUPD DELTA1 Update files for CP ASSEMBLE source 
TEXT VMFRCTXT DELTA Text replacement modules for CP 
“= Text shells created on target disk 
Update shells created on APPLY disk 
AUX files for updates to non-ASSEM parts 
Update files for non-ASSEMBLE parts 
New Source (assemble,macro,copy,$exec...) 
Maclibs are not replaced on the base 
Replacement parts and regenerated 
parts other than maclibs, text, modules 
AMENG HELP files go directly to the 
AMENG help Build disk 
UCENG HELP files go directly to the 
UCENG help Build disk 
RESV *VMFRCCOM DELTA1 Reserved parts 
CPMOD VMFRCCOM BUILD4 CP modules targeted for system disk 
PTFS VMFRCCOM DELTA1 PTF numbered parts other than TXT 


* Fy ES SD TE AD CD a Ey ce a a De i ee re ce ee ee I en se Fe EE Fe. Ee SE 0 ee 0 ee 2 2 8 2 ee oe ee ee 
oo) Ge Ge tee Ge ee ee ee es ee eo ee Ge eG eG se Se ee EE es OG Gs ee es es ee ee et et ee ee 2s ee ee ee ee 


:APP. * Apply Function 


kk 


* PARTTYPE EXEC RENAME * DESCRIPTION 
kk 
TXT* VMFAPTXT TEXT * Create AUX and rename appropriate update 
*% * files to fm5 for names in loadlist. 
ae * Other TXT parts renamed to TEXT 
TAM* VMFAPNLS TXTAMENG * For American English NLS support 
TKA* VMFAPNLS TXTKANJI * For KANJI NLS support 
TUC* VMFAPNLS TXTUCENG * For Uppercase English NLS support 
TPO* VMFAPNLS TXTPORTG * For Brazilian Portuguese NLS support 
TFR* VMFAPNLS TXTFRANC * For French NLS support 
TGR* VMFAPNLS TXTGER * For German NLS support 
AUXXA VMFAPAUX * For MACRO and EXEC AUX files 
AXA* VMFAPAUX AUXXA * For MACRO and EXEC AUX files 
¥ 
* 


kk 


MACAUX VMFRCAUX DELTAI 
MACUPDT VMFRCUPD DELTA] 
SOURCE VMFRCCOM DELTAIL 
MACLIB VMFRCCOM DELTA1 
EXEC VMFRCCOM DELTA1 


kk 


HELP VMFRCCOM BUILD2 


*k* 


HELP VMFRCUPP BUILD3 


** 


+ £ Ft F F HF HF FF SF FF FE FF FE FHF HF F 


* 


EXEC VMFAPCOM 
MACRO VMFAPCOM 


ier VMFAPCOM * ALL PARTS ARE LISTED BY FILETYPE 
A VMFAPCOM * If a part type is not listed 
a ae VMFAPCOM * VMFAPCOM is called by default 


* ee DS OS EE OD Ok ee re ee 2 ee nt re ee ee ee ee 9 ee ee ee eee 
ee Ga te Gere Go dey ee Ce ee cece ee Oe ere ree ee ee ED CD GD SY CS Sere ee ee med eee Ga Se oe Ge em Gee em dea Gea em deh toe 


SS DD A Dy SS Ee OE 


Figure 27 (Part 3 of 4). 56643089 S$PPFTEMP (without Overrides) 
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‘BLD. * Build Function 


kk 


* BUILDLST EXEC TARGET * DESCRIPTION 


kk 


CPLOAD VMFBONUC *BUILD1 * Create CP nucleus based on loadlist 


ls * Target disk symbol agrees with 
we * disk address in HCPSYS ASSEMBLE 
“x * on the SYSRES macro. Defaults to 
lahal * what is in HCPSYS ASSEMBLE if no 
kk % 


target disk is specified. 
kk 

CPYSYSCP VMFBDCPY BUILD4 * Copy TEXT decks that do not become 
"% * part of a MODULE to the system disk 


kk 


CPYBTHCP VMFBDCPY DELTA1 


kk 


Copy TEXT decks used by UTILITY and 
listed in the load list, CPLOAD EXEC, 
to the DELTA disk. VMFAPPLY only 
copies the ones not listed in the 
load list. 


Kk 
kk 


+ + + + 


kk 
kk 
* CPYUTLCP VMFBDCPY DELTA1 
kk 
kk 
ek 
xk 
kk 
kk 
kk 


Copy TEXT decks used by UTILITY which 
are not listed in the load list, 
CPLOAD EXEC. This list would be used 
if you have local modifications and 
you choose not to run VMFAPPLY. All 
TEXT decks for which you have received 
service and/or have local mods would 
be copied as a result. You need to remove 
a the asterisk before CPYUTLCP before 

ne running VMFBLD. 

ais * Use UTILITY to build CP Utilities 


* FER TG OS ALD ES SD OY ES EER SEY gen HB hy Ge en ee EO ee ee ce ee ey ee ee oo se ee ee ee ee 2, ee 2 ee ee ee 
Se ee EE EE SS a eee ee Se et Ge tee eel G eed Geh Ge Ged ome aD Ged deed me emt a Se eh C0 tee ne Sot Ge Gee ec ee Ged Ged ec Ged ed de de te ee ed dd ee ee ee 


END. * End of Parameters for CP 


+ £ + &£ + $F$ *F SF He F 


Figure 27 (Part 4 of 4). 56643089 $PPFTEMP (without Overrides) 


If you issue 
vmfover 56643689 corcp s 


you will get a temporary file with overrides from the override section of the base file, like the file in 
Figure 28 on page 408. 


Note: When you issue VMFREC or VMFAPPLY, use a component name of CP and the COR option 
instead of the CORCP component name to create this temporary file. 
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he SS ES SC Ee es 8 2 ee eee eee 
fomS Cam comms Coch Ca ee Ge CT CS AP EN CaP Ge aD Ch SS RE SS AE A SS SD TS NG SP ES SE SAS SS PR SD a 


*cnno> * Temporary override of CP component 
*#aom= * in PPF of product 56643089 

¥ccc=> ™* by CORCP override section 

*cxc=> * of the PPF for the product 56643089 


RHKEKEKKEKEKEKEKKEEEEKEREEKKREEREEEEEKRERKEEKEEREREREEEREEKEREREEREEREEEREREKE 


* COPYRIGHT - 5664-308 - (c) COPYRIGHT IBM CORP.- 1989 
- LICENSED MATERIAL - PROGRAM PROPERTY OF IBM 


* SEE COPYRIGHT INSTRUCTIONS, 6120-2083 
KHRKEKKEKEEEKKKEKEAEKEAAEEEREREEKEEEEKEREEREKEEREKEKREEKEEEEEREEREEKKEEEEEE 
BT a a ar a Se a ee 
: Product Parameter File for VM/XA SP Release 2.1 
*€ecscocccccssssscemmsess ee ssssccmmasmaaSessssssamascmanammmaeseeeee ses 
* 

* The following APAR's have been applied to this file: 

* 

* APAR Date Description 

* SSS coe SS So ead See es Sed ees Se ae Ss See ee Se ee DS SS SD Sa Ga SG SoD Sam Aaa Se Soe Ga Sen SD GS SD OS SE SE SP SO A SA Ee a 
* 

* 

*ooecocmcccccemsssessrssrssscsscsssccmscscesssss SoS SSS SS SS SS SS SSS SS SS 
" NOTE: All tags must be in uppercase. 


: A 8 A rE gD te ee ee rr EP ee ee 2 ee ee eee 


* Start of Product Header - List of Components in VM/XA SP Release 2.1 


k*—— ES ED SED ND EG SD NS NG GG Pa Pah PP ee Oe EY GENS HS PS ED SD ED ES SD PD SD ND SD SS NY EE SS RD ES NS NS NG ANP. CN PD ey NS EE ES TE SE EE 
ooocoScoScocoCa= 2 NE TO GPS SE. EY aha uD fied dee Gas Soe Gent ded dee A Ge et Go Ge OE CD SC NS CRA CN GD Se ND CD de Ge te a ee Oe Ee eh ee ed ie Ce dem det de es, ee Oy SP a Sd ee EE Ge a Ge Age CP aS Cae eo 


sCOMPLST. CP se CMS DV GCS 
sOVERLSTP. 
sOVERLST. 


* ES GS GEE SP S-SED ED FOUD ES ED FE OE OD OD OP 00 8 es Oe ee ee ee ee ee ee ee re ee ee ee re ce ee ee re ee ee re 8 8 se re Se 8 8 Oe ees oes eer 
on toed dos doe) ee ee eee eee GE EG EY Ee God ee) Gey Ged Gee Co) Ge ee) dee Gee ed seed eo) Ga ce eo ed es ed Seed ed ed Go Cer ee) Ge ee ee ee oe Ce de Coy ce ee cg Ge ST SE Get Comm City Coe Ga ee eG Se 


* End of Product Header 


¥ ee 8 ee eee FD OG GO aly EP SS CES AD EE SD SS ED ED A ST ee Ge me Qe ee ey OP EG OR PG OP Oe es ee ee eee ee ee ee ee 
ee a a Sy ey eet a ee ee Cee Se eee me Cee eed Gem ed em ems emda cs es as ca cm ceed deme eee cee Cee Cee deen deen ee Ge dee ee Se ee eee re ee es ee ee ee et es Cad: at er te Se Ge ree See ee 


* ee ne ne ete age et gg ee ee Ee NE Ee ee ee en ee ne EE 8 8 ED 8 NE ED er se ee ee et ee 8 SE SE Ee Ee 
a eed ee Gee eet eet ee Cement ee eee ee ements ee as as aes es Rh ge a I PS A ee eh See ee re ee ee Gert ee SD SD ED EC ED ae See? Cae Cee Ged Gee deed Ged eet Gee ee ee ed ee eee eee 


sCP. * Start of Parameters for CP 
*sosccsssssscscseesscccnssssssseressssssssssssssssscSssssesesssssccccssccsss 
:CNTRLOP. * Section one - Control Options 

=o * DO NOT DELETE THESE CONTROL TAGS 

* TAG VALUE(S) * DESCRIPTION 

*&k 

sCNTRL. HCPXA * Control Filename 

sUPDTID. | AUXXA * Update level identifier for building AUX 
sSLVI. A/HP A/PP * System level and version indicators 

:NLS. AMENG * System Language 

sUSEREXIT. VMFUECP * User exit EXEC. Called before initial 

7 * accesses and after final access retore. 
we * 2 paramters passed will indicate calling 
sas * EXEC and SET-UP or CLEAN-UP. 

* ee ae Sa es ee ee ee eed ee Se es Se me eS ee ee Se ee eo ae a a a ae a 
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:MERGE. 
* MERGE. 
:LTO. 

sCKTXT. 
sCKUPD. 
:CKAUX. 


APPLYX DELTAX 
DELTA1 APPLY 


* 


+ + £ HF 


Merge dummy APPLY and DELTA strings 


* Disk strings to be merged at Receive 


Erase lower level TEXT decks at Receive 
Check for full text at Apply 

Check update fm regardless of $PTFPART fm 
Check composite AUX at Build 

Check Requisites at Build 


8S ED EF ED ED eS Ee EE ED my gee a ce en ee ES ES Ny a ee eS EN SONG eS ED Ey a Plenty SD G-SS GNP NS GS SPY PP AP 


* 


TASK 
LOCAL1 
*LOCALn 
APPLY 
*APPLYn 
DELTA1 
*DELTAn 
BASE1 
BASE2 
*BASEn 
*BUILDI 
BUILD2 
BUILD3 
BUILD4 
*BUILDn 
SYSTEM 


* STRNGNAM MINIDISKS 
* 


5E5 
295 


492 291 292 
594 691 294 


194 
394 


423 


Section two - Mini-Disk Assignments 
STRING NAMES MUST START IN COLUMN 1 
DESCRIPTION 


Build disks accessed before rest of dbase 
Disks for local service | 

You may define additional LOCAL disks 
Control structure built by service execs 
You may define additional APPLY disks 

CP service from TAPE 

You may define additional DELTA disks 

CP text, loadlist,control file,maclibs 

CP source,macro defs,and copy files 

You may define additional BASE disks 

New SYSRES for CP Nucleus Build 

New CMS system disk for AMENG HELP files 
New CMS system disk for UCENG HELP files 
New CMS system disk for nucleus etc. 

You may define additional BUILD disks 
Disks reqd for your system environment 


APPLYX 
DELTAX 


kk 
kk 
kk 
kk 


:PRTFNC. 


492 291 
594 591 


Define dummy APPLY string 

Define dummy DELTA string 

During corrective service merges are per- 
formed based on these dummy strings. The 
intermediate disks act as collectors for 
corrective service until the next PUT. 
Section three - Part type/Function List 


:RECSER. 


kk 


* TAPEFILE 


**k 


AXLIST 


PARTLST 


UPDT 
TEXT 


*x* 
*&* 


MACAUX 


MACUPDT 


SOURCE 
MACLIB 
EXEC 


kk 


EXEC TARGET 
YMFRCAXL DELTA1 
VMFRCCOM DELTA1 
VMFRCUPD DELTA1 
VMFRCTXT DELTA1 


VMFRCAUX DELTA1 
VMFRCUPD DELTA1 
VMFRCCOM DELTA1 
VMFRCCOM DELTA1 
VMFRCCOM DELTA1 


+ 


* 
* 
* 
* 
* 
& 
* 
¥ 
* 
* 
* 
* 


Receive (Service) 
DESCRIPTION 


Apply and Exclude lists 

PTF Parts Lists 

Update files for CP ASSEMBLE source 

Text replacement modules for CP 

Text shells created on target disk 
Update shells created on APPLY disk 

AUX files for updates to non-ASSEM parts 
Update files for non-ASSEMBLE parts 

New Source (assemble,macro,copy,$exec...) 
Maclibs are not replaced on the base 
Replacement parts and regenerated 

parts other than maclibs, text, modules 
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HELP VMFRCCOM BUILD2 * AMENG HELP files go directly to the 
* * AMENG help Build disk 

HELP VMFRCUPP BUILD3 * UCENG HELP files go directly to the 
is * UCENG help Build disk 

RESV *VMFRCCOM DELTA1 ™* Reserved parts 

CPMOD VMFRCCOM BUILD4 * CP modules targeted for system disk 

PTFS VMFRCCOM DELTAlL ™* PTF numbered parts other than TXT 


* 


* 


sAPP. * Apply Function 


* PARTTYPE EXEC RENAME ™* DESCRIPTION 
* 


* 
TXT* VMFAPTXT TEXT 

we 

ee 


Create AUX and rename appropriate update 
files to fm5 for names in loadlist. 
Other TXT parts renamed to TEXT 

TAM* VMFAPNLS TXTAMENG * For American English NLS support 

TKA* VMFAPNLS TXTKANJI * For KANJI NLS support 

TUC* VMFAPNLS TXTUCENG * For Uppercase English NLS support 

TPO* VMFAPNLS TXTPORTG * For Brazilian Portuguese NLS support 
TFR* VMFAPNLS TXTFRANC * For French NLS support 


+ + + 


TGR* VMFAPNLS TXTGER * For German NLS support 

AUXXA VMFAPAUX * For MACRO and EXEC AUX files 

AXA* VMFAPAUX AUXXA * For MACRO and EXEC AUX files 

EXEC VMFAPCOM . 

MACRO VMFAPCOM * 
we, VMFAPCOM * ALL PARTS ARE LISTED BY FILETYPE 
wie VMFAPCOM * If a part type is not listed 
see VMFAPCOM * VMFAPCOM is called by default 
*coccsccssescmccssssssssesccmssesrssse sees sreressesssoscs 
:BLD. * Build Function 


* BUILDLST EXEC TARGET ™* DESCRIPTION 
* 


* 
CPLOAD VMFBDNUC *BUILD1 

kk 
kk 
kk 
kk 
kk 
kk 


CPYSYSCP VMFBDCPY BUILD4 * Copy TEXT decks that do not become 
= part of a MODULE to the system disk 


Create CP nucleus based on loadlist 
Target disk symbol agrees with 

disk address in HCPSYS ASSEMBLE 

on the SYSRES macro. Defaults to 
what is in HCPSYS ASSEMBLE if no 
target disk is specified. 


t+ £ + + EF F 


* 
** 


CPYBTHCP VMFBDCPY DELTAL * Copy TEXT decks used by UTILITY and 
aad * listed in the load list, CPLOAD EXEC, 
sia * to the DELTA disk. VMFAPPLY only 
shal * copies the ones not listed in the 


*e * load list. 
*&* 


* 
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* CPYUTLCP VMFBDCPY DELTA] 


kk 


* Copy TEXT decks used by UTILITY which 
* are not listed in the load list, 
* CPLOAD EXEC. This list would be used 
* if you have local modifications and 
* you choose not to run VMFAPPLY. All 

“ * TEXT decks for which you have received 
* 
* 
* 
* 


kk 
kk 
kk 


bs service and/or have local mods would 


be copied as a result. You need to remove 
the asterisk before CPYUTLCP before 

iad running VMFBLD. 

ae * Use UTILITY to build CP Utilities 


PD SES CEE SM ERED S-D ea GES ES  PP  S 


kk 
xk 


* End of Parameters for CP 


Figure 28 (Part 4 of 4). 56643089 $PPFTEMP (with Corrective Service Overrides) 


If you have a VM/XA $PPF file like the one in Figure 26 on page 403 and you issue: 
vmfover vmxa cp 8 


you will get a temporary file, that looks just like the file in Figure 27 on page 404. 


The Program Update Tape (PUT) 


The format of each volume of the PUT is as follows: 


¢ The first tape file contains the PUT DOCUMENT, the VMSERV EXEC, and the latest tested level of 
the service EXECs (with PTF-numbered filenames). 


¢ The second tape file contains a Memo to Users for each program product service on the volume, and the 
latest tested level of the product parameter file for each product on the tape. 


¢ The remaining tape files contain service files for the program products on that volume. 


Figure 29 on page 412 shows the format of the PUT tape. 
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PUT 8801 <=== PUT Descriptor File 
PUT Document <=== PUT Content and Instructions 
VMSERV = EXEC <=== Compatible Service EXEC 


prodid! crlinnl <=== Program Level File 
prodid1 MEMO <=== Instructions for product 
prodid! $PFnnnnn <=== Product Parameter File 


prodid2 criinn0 

prodid2 MEMO 

prodid3 crttnnl 

prodid3 MEMO 

prodid3 $PFnnnnn <=== Product Parameter File 
prodid4 crlinnl 

prodid4 MEMO 

prodid4 $PFnnnnn <=== Product Parameter File 


a eee Tape Mark sssssscemesscsssscscscssss 


prodidl crlinnl 


prodidl $PUTannnl <=== Product Contents Directory 
<cs= (Flag byte 1 indicates new format) 
Soom see Tape Mark soooscscsscccsssscccmmmsoss 


COMP1 PARTIA <=== Group processed according to Part 1 
COMP1 PARTIB as described in PPF in terms of process 
COMP1 PARTIC destination. 


COMP1 PARTID 
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memes sme Tape Mark sosessesssesscosmeesssssss 


COMP1 PART2E <=== Processed according to Part 2 in PPF 
COMP1 PART2F 
COMP1 PART2G 


COMP1 PART3H <=== Processed according to Part 3 in PPF 
a Tape Mark SSS SSS SSS SSS SSS SSS 


COMP2 PARTIA <=== Processed according to Part 4 in PPF 
COMP2 PARTIB 


COMP2 PART2C <=== Processed according to Part 5 in PPF 
COMP2 PART2D 
COMP2 PART2E 
COMP2 PART2F 
COMP2 PART2G 


prodid2 crlinn0 <=== Flag byte 0 indicates compatible 
prodid2 EXEC format 
SSSSSSSSSSSSSSSSssessssss Tape Mark SSSloSoS eos eSSSSSsSSSS SSS SS 


COMP1 PARTIA <=== Group processed by product exec 
COMP1 PARTIB 


COMP1 PARTIC <s== Group processed by product exec 
COMP1 PARTID 
COMP1 PARTIE 
COMP1 PARTIF 


Figure 29 (Part 2 of 3). Format of the Program Update Tape 
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CRLLNNF - C = COREQ Flag (C or 0) 
R = Release Level of product or SCP 
Li= PTF Level of Product or PLC level SCP 
NN= Total number of files (TM's) on PUT for this Product 
F = 1 indicates new format, 0 indicates compatible format 


Figure 29 (Part 3 of 3). Format of the Program Update Tape 


Although the VMSERV EXEC and service EXECs for each product are still provided on the PUT tape, you 
must use the new service EXECs, VMFREC, VMFAPPLY, and VMFBLD, to receive and apply service to 
CP, CMS, GCS, and the dump viewing facility. These EXECs are loaded from the VM/XA SP product tape 
when you install the system. You can still use VMSERV to receive and apply service to other program 
products. See Chapter 10 through Chapter 18 for examples of using the new EXECs. 


IBM packages service for VM/XA SP as service level updates. Periodically, or whenever you request it, IBM 
ships a service level update. This includes cumulative preventive maintenance since the last release of 
VM/XA SP. 


You may find that there is more than one preventive update on a PUT tape. 


The Corrective Service Tape (COR) 


For new format products, the format of the COR tape is exactly the same as the format of the PUT tape, 
except that only the tape files containing parts that actually need corrective service are included, and the 
VMSERV EXEC is not included. 
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Chapter 9. Preparing For Service 


This chapter describes how to establish an alternate level of build disks to use when servicing your system. 


Step 1. Minidisk Accesses 


Before you begin processing service, you must have access to the service tools on the TASK disk (SES). You 
should include this access in your PROFILE EXEC: 


access 5E5 b 


Step 2. Establish an Alternate Set of Build Disks 


Before you service your VM/XA System Product Release 2.1 system, you should create an alternate level of 
build disks. This isolates the changed system so it can be tested before you make it available to your general 
user community. 


1. Use the DASD DUMP Restore program to copy the current BUILD! disk to its corresponding alternate 
disk: 


ddr # 

VM/XA SYSTEM PRODUCT DASD DUMP RESTORE PROGRAM 

ENTER: 

sysprint cons Hi This command tells DDR to send program 

ENTER: messages to your console. 

input 190 devtype MNT190 @ 190 is your current CMS system disk. devtype is 

ENTER: the device type of the DASD volume where 190 is 
located. 

output 490 devtype MNT490 Mf 490 is your alternate CMS system disk. devtype is 

ENTER: the device type of the DASD volume where 490 is 
located. 

copy 900 endcy! @& The value for endcyl depends on the device type of 


your 190 disk: 
Device Type endcyl 


3350 73 
3375 112 
3380 7\ 
3390 67 
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DMKDDR711R Volid Read is MNT190. Do you You have not yet changed the label of the 490 
wish to continue? minidisk. (You will do so in substep 2.) This 

yes prompt will not always appear. 

ENTER NEXT EXTENT OR NULL LINE: 

si 


END OF COPY 
ENTER: 

3 

END OF JOB 


. Relabel the 490 minidisk: 


access 490 t Mf Access 490 after the system disk. You must use 
Ready; T=n.nn/n.nn hh:mm:ss the label option. If you don’t, you will erase all 
format 4960 t (label the files on the 490 minidisk. 

ENTER LABEL: 

mnt490 


Ready; T=n.nn/n.nn hh:mm:ss 


. Repeat substeps | on page 415 and 2 to copy the current HELP disks (19D, 19C, 19B...) to their 


corresponding alternate disks (49D, etc.) and to relabel the alternate disks as MNT49n. Check the 
minidisk definitions in your user directory to find the appropriate value for endcyl. 


Note: There is one HELP disk for each national language supported on your system. If you only 
support one national language, you only have to do this substep once. 


What to Do Next 


To begin servicing CMS, see Chapter 10, “Receiving Service for CMS” on page 417. 
To begin servicing CP, see Chapter 11, “Receiving Service for CP” on page 423. 

To begin servicing DV, see Chapter 16, “Service to DV” on page 507. 

To begin servicing GCS, see Chapter 17, “Service to GCS” on page 517. 
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Chapter 10. Receiving Service for CMS 


This chapter describes how to receive service from the PUT or COR tape for CMS. 


Step 1. Preparation 


Before you begin processing PUT or COR service, you must: 


? 


bo 


Establish the appropriate minidisk access order: 


vmfsetup 56643089 cms 


. After you receive and apply service to CMS, you will want to keep the newly built CMS separate from 


the production CMS you are currently running. To do this, you must edit the DMSNGP ASSEMBLE 
file: 


Copy the latest version of the DMSNGP ASSEMBLE file to the 395 disk. (If there is already a copy of 
DMSNGP ASSEMBLE or DMSNGP TEXT on the 395 disk, rename it first.) Edit the copy and make 
the following changes: 


a. Change SYSDISK = 190 to SYSDISK = 490. 
b. Change IPLADDR = 190 to IPLADDR = 490. 
c. Change HELP=19D to HELP =49D (or HELP=19C to HELP =49C). 


d. Change SYSNAME=CMS to SYSNAME=newname, where newname is the name you choose for 
your test system. The sample procedure in Chapter 14, “Rebuilding CMS after Applying Service,” 
uses ALTCMS. 


e. Change INSTSEG = CMSINST to INSTSEG = newname, where newname is the name you choose for 
your test installation segment. The sample procedure in Chapter 14, “Rebuilding CMS after 
Applying Service,” uses ALTINST. 


f. Change the VERSION = and INSTID= parameters to identify your test system. 


g. Make sure that SAVESYS=NO. If SAVESYS= YES, when you IPL CMS the system will try to 
save the alternate CMS segment that you will define in Step 10 of Chapter 14, “Rebuilding CMS 
after Applying Service” in the existing CMS segment. 


These changes will cause the new CMS nucleus (with service) to be built on the 490 minidisk. (If you 
have applied service before and the nucleus you are using now is on the 490 minidisk, SYSDISK and 
IPLADDR are already 490. Change them back to 190 so that the new nucleus will be built on the 190 
minidisk. ) 


. You will probably want VMFREC to merge the DELTA and APPLY minidisk strings in accordance 


with the :MERGE. tag in the product parameter file. If you want to do it manually, or if you want to 
keep any disk string from being merged, see Appendix G, “Controlling Disk String Merges” on 
page 861. 
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4. Determine your system default national language: 


query lang @ langid can be: 

ed Langid Language 
AMENG Mixed-case American English 
KANJI Kanji (Japan) 


UCENG Uppercase American English 
PORTG Brazilian Portuguese 
FRANC French 

GER German 


If the system default national language is uppercase American English (UCENG), you must make these 
changes: 


a. Change the :NLS. tags in the product parameter file from AMENG to UCENG. 
b. Convert the following files to uppercase: 

e $VMFMSG$§ EXEC 

e $VMFMSG$ $EXEC 


xedit $vmfmsg$ jexec|$exec' Ml 
uppercas * Mi 
file 


Note: If you receive service to these files, you must copy the changes in the replacement files to your 
modified version. 


c. In the DMSNGP ASSEMBLE file, change the LANG parameter from AMENG to UCENG and the 
HELP disk address from 19D to 19C. 


5. Rename the latest level of DMSNGP TEXT to save your old text file, then reassemble the DMSNGP 
ASSEMBLE file to include the changes you made in substeps 2 and 4: 


vmfhasm dmsngp 56643089 cms @ 


6. Copy the newly created DMSNGP TEXT file from your A-disk to your LOCAL! disk and erase 1t from 
your A-disk: 


copyfile dmsngp text a = = fm (olddate replace M fm is the LOCAL] (395) disk. 
erase dmsngp text a Hf 
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Step 2. Receive Service 


| Note: If you are using ServiceLink to receive service electronically, use the procedure in Chapter 19, “Using 


I. 


ServiceLink to Receive Service” on page 533 to receive the service. 


Attach a tape drive to MAINT: 


attach vdevno * 181 @& 


. Mount and ready the PUT or COR tape. 


. Map the PUT or COR tape and receive the documentation. Mapping the tape means venfying that all 


the necessary files exist. Enter: 


release c @ VMFREC INFO (MEMOS xxx loads documents 
to the C-disk if it is accessed, otherwise to the 
A-disk. 
vmfrec info (memos xxx Hf xxx is put if you are mapping a PUT tape, or cor 
DMSREC1852I This is rn of n, if you are mapping a COR tape. If the tape you 
level level {PUT|COR} tape mounted is not the type of tape you specified. you 


receive an error message. 


VMFREC INFO (MEMOS maps the tape and 
loads the tape map, PUT DOCUMENT or COR 
DOCUMENT, and the Memo to Users (56643089 
MEMO) to your A-disk. Read these documents 
before going on. Print the documents to save a 
record of them. If you do not save a copy of 
these documents, they will be over-written the next 
time you receive a PUT or COR tape. 


If your system default language is uppercase 
American English, you may get message 
DMSMGMB8I4E. This message is caused by a 
problem with the REXX date function. You can 
ignore it. 


Ready; T=n.nn/n.nn hh:mm:ss 


. Review the receive exception log ($VWMFREC $ERRLOG) to be sure that the MEMOs were loaded 


correctly: 


vmfview receive 


. Receive the service files to the target minidisks you specified in the product parameter file. Enter: 


vmfrec 56643089 cms (xxx @ xxx 1s put for a PUT tape, or cor for a COR tape. 
DMSREC1852I This is n of n, If you need to invoke an override file, substitute 
level level {PUT|COR} tape that file’s name for 56643089. 
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DMSREC1869R 56643089 CMS begins on {PUT|COR} If you do not have the correct volume mounted, 
level volume vol. Mount mount it now. 


correct volume and press ENTER = 11. VMFREC EXEC loads the service files to the 


: or type QUIT. target minidisk. 


DMSREC18521 This is n of n, 
level level {PUT|COR} tape 
DMSREC1804I Receiving service for 
component CMS of product 
56643089 


DMSREC1850I The processing for RESV by the 
VMFRCCOM EXEC was bypassed 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Review the receive exception log (SVMFREC $ERRLOG), and correct any problems before continuing: 


vmfview receive 
Ready; T=n.nn/n.nn hh:mm:ss 


| To Receive More Than One COR Tape | 


If you want to receive additional COR tapes at this time: 


1. You must suppress the automatic merging that occurs before a receive. See “Preventing Automatic 
Merging” in Appendix G, “Controlling Disk String Merges” on page 861, and choose a method of 
preventing automatic merging. 


2. For each COR tape you want to receive, repeat substeps 2 — 6. 


3. Create an apply list for the VMFAPPLY EXEC to use that contains the PTFs from all the COR tapes 
you just received: 


listfile dmsxa $apc* fm @ fm is the alternate DELTA disk (593). 
DMSXA $APCALL fm 
DMSXA $APCO109 fim 
DMSXA $APCO119 fm 
DMSXA $APCO126 fim 
DMSXA $APC9C22 fm 


xedit dmsxa $applist fm @ Edit the DMSXA $APPLIST file on the alternate 
get $apcymdd DELTA disk. This file will already contain the 
file @ apply list from the last tape you loaded. Doa 


GET command in XEDIT once for each 
remaining DMSXA $APCymdd file shown by your 
LISTFILE command. 


Note: If the VMFAPPLY EXEC encounters duplicate entries for the same PTF, it issues a message that 
the PTF has already been applied. This is an informational message; you can ignore it. 
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| 


4. Create an exclude list for the VMFAPPLY EXEC to use that contains the excluded PTFs from all the 


COR tapes you just received: 


Note: Do not be concerned if the exclude lists are empty. 


listfile dmsxa $exc* fm @ 


DMSXA 
DMSXA 
DMSXA 
DMSXA 
DMSXA 


xedit dmsxa $exclist fm Mi 
get Sexcymdd M file @ 


$EXCALL fm 
$EXCO109 fm 
$EXCQ119 fim 
$EXCO126 fim 
$EXCOC22 fim 


fm is the alternate DELTA disk (593). 


Edit the DMSXA $EXCLIST file on the alternate 
DELTA disk. This file will already contain the 
exclude list from the last tape you loaded. Doa 
GET command in XEDIT once for each 
remaining DMSXA $EXCymdd file shown by your 
LISTFILE command. 


ees End of To Receive More Than One COR Tape oo a 


What to Do Next 


e If you are also servicing CP, you must receive the service for CP before applying the service to CMS. 
See Chapter 11, “Receiving Service for CP” on page 423. 


¢ Otherwise, continue with service to CMS. See Chapter 12, “Applying Service to CMS” on page 427. 


Chapter 10. Receiving Service for CMS 421 


Chapter 11. Receiving Service for CP 


This chapter describes how to receive service from the PUT or COR tape for CP. 


Step 1. Preparation 


Before you begin processing PUT or COR service, you must: 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cp Mf 


2. You will probably want VMFREC to merge the DELTA and APPLY minidisk strings in accordance 
with the :MERGE. tag in the product parameter file. If you want to do it manually, or if you want to 
keep any disk string from being merged, see Appendix G, “Controlling Disk String Merges” on 


page 861. 


3. Determine your system default national language: 


Note: If you have already done this substep as part of receiving service for CMS, you do not need to do 


it again. 


query lang Mf langid can be: 


pong Langid 


AMENG 
KANJI 
UCENG 
PORTG 
FRANC 
GER 


Language 

Mixed-case American English 
Kanji (Japan) 

Uppercase American English 
Brazilian Portuguese 

French 

German 


If the system default national language is uppercase American English (UCENG), you must make these 


changes: 


a. Change the :NLS. tags in the product parameter file from AMENG to UCENG. 


b. Convert the following files to uppercase: 


e S$VMFMSG$ EXEC 
¢ SVMFMSG$ $EXEC 


xedit $vmfmsg$ {EXEC|$EXEC} Ml 
uppercas * Hf 
file @ 


Note: If you receive service to these files, you must copy the changes in the replacement files to your 


modified version. 
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Step 2. Receive Service 


Note: If you are using ServiceLink to receive service electronically, use the procedure in Chapter 19, “Using 


1. 


bo 
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ServiceLink to Receive Service” on page 533. 


Attach a tape drive to MAINT: 


attach vdevno * 181 @ 


. Mount and ready the PUT or COR tape. 


. Map the PUT or COR tape and receive the documentation. Mapping the tape means verifying that all 


the necessary files exist. Enter: 


release c @ VMFREC INFO (MEMOS xxx loads documents 
to the C-disk if it is accessed, otherwise to the 
A-disk. 
vmfrec info (memos xxx @ xxx is put if you are mapping a PUT tape, or cor 
DMSREC1852I This is n of n, if you are mapping a COR tape. If the tape you 
level level {PUT|COR} tape mounted is not the type of tape you specified, you 


receive an error message. 


VMFREC INFO (MEMOS maps the tape and 
loads the tape map, PUT DOCUMENT or COR 
DOCUMENT, and the Memo to Users (56643089 
MEMO) to your A-disk. Read these documents 
before going on. Print the documents to save a 
record of them. If you do not save a copy of 
these documents, they will be over-written the next 
time you receive a PUT or COR tape. 


If your system default language is uppercase 
American English, you may get message 
DMSMGMS8I4E. This message is caused by a 
problem with the REXX date function. You can 
ignore it. 


Ready; T=n.nn/n.nn hh:mm:ss 


Review the receive exception log (SVMFREC $ERRLOG) to be sure that the MEMOs were loaded 
correctly: 


vmfview receive Hi 


. Receive the service files to the target minidisks you specified in the product parameter file. Enter: 


vmfrec 56643089 cp (xxx Mf xxx is put for a PUT tape, or cor for a COR tape. 
DMSREC1852I This is n of vn, If you need to invoke an override file, substitute 
level level {PUT|COR} tape that file’s name for 56643089. 
Installation and Service 


DMSREC1869R 56643089 CP begins on {PUT|COR} If you do not have the correct volume mounted, 
level volume vol. Mount mount it now. 
correct volume and press ENTER 
The VMFREC EXEC loads the service files to the 
or type QUIT. Sa tne 
™ target minidisk. 
DMSREC1852I This is n of n, 
level level {PUT|COR} tape 
DMSREC1804I Receiving service for 
component CP of product 
56643089 


Ready; T=n.nn/n.nn hh:mm:ss 


. Review the receive exception log (SVMFREC $ERRLOG), and correct any problems before continuing: 


vmfview receive 
Ready; T=n.nn/n.nn hh:mm:ss 


| To Receive More Than One COR Tape | 


If you want to receive additional COR tapes at this time: 


1. You must suppress the automatic merging that occurs before a receive. Read “Preventing Automatic 


Merging” on page 861 in Appendix G, “Controlling Disk String Merges” on page 861 and choose a 
method of preventing automatic merging. 


. For each COR tape you want to receive, repeat substeps 2 — 6. 


. Create an apply list for the VMFAPPLY EXEC to use that contains the PTFs from all the COR tapes 


you just received: 


listfile hcpxa $apc* fm Hf fm is the alternate DELTA disk (593). 
HCPXA $APCALL fm 
HCPXA $APC0109 fin 
HCPXA $APCO119 fm 
HCPXA $APCO126 fm 
HCPXA $APC9C22 fm 


xedit hcpxa $applist fm @ Edit the HCPXA $APPLIST file on the alternate 
get $apcymdd @ DELTA disk. This file will already contain the 
file @ apply list from the last tape that you loaded. Do 


a GET command in XEDIT once for each 
remaining HCPXA $APCymdd file shown by your 
LISTFILE command. 


Note: If the VMFAPPLY EXEC encounters duplicate entries for the same PTF, it issues a message 
telling you that the PTF has already been applied. This is an informational message; you can 
ignore it. 


. Create an exclude list for the VMFAPPLY EXEC to use that contains the excluded PTFs from all the 


COR tapes you just received: 


Note: Do not be concerned if the exclude lists are empty. 
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listfile hcpxa $exc* fm Mf 


HCPXA 
HCPXA 
HCPXA 
HCPXA 
HC!XA 


xedit hcpxa $exclist fm Hf 


$EXCALL fm 
$EXCO109 fm 
$EXCO119 fm 
$EXCO126 fm 
$EXC9C22 fm 


get $excymdd @ 


file H 


fm is the alternate DELTA disk (593). 


Edit the HCPXA $EXCLIST file on the alternate 
DELTA disk. This file will already contain the 
exclude list from the last tape that you loaded. 

Do a GET command in XEDIT once for each 
remaining HCPXA $EXCymdd file shown by your 
LISTFILE command. — 


ee End of To Receive More Than One COR Tape ee 


What to Do Next 


e If you are also servicing CMS, you must apply the service for CMS before you apply service to CP. See 


Chapter 12, “Applying Service to CMS” on page 427. 


¢ Otherwise, continue with service to CP. See Chapter 13, “Applying Service to CP” on page 429. 
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Chapter 12. Applying Service to CMS 


| | This chapter describes how to apply service from the PUT tape or COR tape to CMS. 


Warning: If you are servicing both CP and CMS, you must receive both CP and CMS service before 
applying service to CMS, because you need CP macro libraries to apply service to CMS. Some of these 
libraries may have been serviced. 


| Should You Be Doing This Now? 
| © Ifyou have not yet received service for CMS, see Chapter 10, “Receiving Service for CMS” on page 417. 


| © If you are also servicing CP, you must receive the service for CP before applying the service to CMS. If 
| you have not yet received service for CP, see Chapter 11, “Receiving Service for CP” on page 423. 


| ¢ Otherwise, continue with this chapter. 


1. Consult your IBM service representative for the appropriate preventive service planning (PSP) bucket for 
your system’s VMSUP level and PUT level. Check the bucket and add the appropriate entries to the 
| exclude list. The exclude list is called DMSXA $EXCLIST. 


Note: If two PTFs are in the same text deck, you cannot exclude the first unless you also exclude the 
second, even if you list the first one on the exclude list. This restriction applies because the first 
PTF is considered to be a prerequisite for the second PTF. 


If you list the first PTF in the exclude list, but not the second, and if the second PTF appears in 
the apply list, both PTFs will be applied. You will receive an error message indicating that a PTF 
you wanted to exclude has been applied. 


2. Establish the appropriate minidisk access order: 


| vmfsetup 56643089 cms 


3. Apply the service, that is, create auxiliary control files. Enter: 


vmfapply 56643089 cms (xxx Hf xxx 1s put for PUT service, or cor for COR 
DMSAPP1853I Processing PTF ptfnum service. 


Ready; T=n.nn/n.nn hh:mm:ss 


4. Review the apply exception log (SVMFAPP $ERRLOG), and correct any problems before continuing. 
| The information in the apply exception log is used later when you rebuild CMS. 
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vmfview apply 


If you receive message number DMSAPP1885W, 
VMFAPPLY has applied service to a module for 
which you have a local modification. 


You can use the PF keys with the VMFVIEW 
EXEC to get useful lists of information. If you 
position the cursor on a line that contains message 
1885W and press PF2, VMFVIEW displays all the 
occurrences of message 1885W. Similarly, if you 
press PF6, VMF VIEW displays all the messages 
with the BD: prefix. You can use the XEDIT 
PUT command to save these messages in a file for 
future reference. 


Decide what you want to do with the local modification: 


To remove a local modification, see Chapter 20, “Receiving and Applying Local Service” on 
page 543, and Chapter 22, “Removing Service from VM/XA SP” on page 559. 


To rework a local modification, see Chapter 20, “Receiving and Applying Local Service” on 


page 543. 


To keep a local modification, do nothing now. You will regenerate the part to pick up the local 


modification when you rebuild CMS. 


Save the names of all the parts for which you have both local modifications and IBM service. You will 


need the part names later when you rebuild CMS. 


Whether you remove, rework, or keep local modifications, you do not have to reissue VMFAPPLY. 


What to Do Next 


e If you are also servicing CP, you must apply the service for CP before you rebuild CMS. See 


Chapter 13, “Applying Service to CP” on page 429. 


e Otherwise, continue with service to CMS. See Chapter 14, “Rebuilding CMS after Applying Service” on 
page 431. 
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Chapter 13. Applying Service to CP 


This chapter describes how to apply service from the PUT or COR tape to CP. 


Should You Be Doing This Now? 


e If you are also servicing CMS, you must apply the service to CMS before applying the service to CP. If 
you have not yet applied service to CMS, see Chapter 12, “Applying Service to CMS” on page 427. 


e Otherwise, continue with this chapter. 


1. Consult your IBM service representative for the appropriate preventive service planning (PSP) bucket for 
your system’s VMSUP level and PUT level. Check the bucket and add the appropriate entries to the 
exclude list. The exclude list is called HCPXA $EXCLIST. 


Note: If two PTFs are in the same text deck, you cannot exclude the first unless you also exclude the 
second, even if you list the first one on the exclude list. This restriction applies because the first 
PTF is considered to be a prerequisite for the second PTF. 


If you list the first PTF in the exclude list, but not the second, and if the second PTF appears in 
the apply list, both PTFs will be applied. You will receive an error message indicating that a PTF 
you wanted to exclude has been applied. 


2. Establish the proper minidisk access order: 


vmfsetup 56643089 cp # 


3. Apply the service, that is, create auxiliary control files. Enter: 


vmfapply 56643089 cp (xxx @ xxx 1s put for PUT service, or cor for COR 
DMSAPP1853I Processing PTF ptfnum service. 


Ready; T=n.nn/n.nn hh:mm:ss 


4. Review the apply exception log (SVMFAPP $ERRLOG), and correct any problems before continuing. 
The information in the apply exception log is used later when you rebuild CP. 


vmfview apply If you receive message number DMSAPP1885W, 
VMFAPPLY has applied service to a module for 
which you have a local modification. 


You can use the PF keys with the VMFVIEW 
EXEC to get useful lists of information. If you 
position the cursor on a line that contains message 
1885W and press PF2, VMFVIEW displays all the 
occurrences of message 1885W. Similarly, if you 
press PF6, VMF VIEW displays all the messages 
with the BD: prefix. You can use the XEDIT 
PUT command to save these messages in a file for 
future reference. 
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Decide what you want to do with the local modification: 


¢ To remove a local modification, see Chapter 20, “Receiving and Applying Local Service” on 
page 543, and Chapter 22, “Removing Service from VM/XA SP” on page 559. 


¢ To rework a local modification, see Chapter 20, “Receiving and Applying Local Service” on 
page 543. 


¢ To keep a local modification, do nothing now. You will regenerate the part to pick up the local 
modification when you rebuild CP. 


Save the names of all the parts for which you have both local modifications and IBM service. You will 
need the part names later when you rebuild CP. 


Whether you remove, rework, or keep local modifications, you do not have to reissue VMFAPPLY. 


What to Do Next 


¢ If you are also servicing CMS, you must rebuild CMS before you rebuild CP. See Chapter 14, 
“Rebuilding CMS after Applying Service” on page 431. 


e¢ Otherwise, continue with service to CP. See Chapter 15, “Rebuilding CP after Applying Service” on 
page 487. 
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Chapter 14. Rebuilding CMS after Applying Service 


This chapter describes a step-by-step procedure for rebuilding CMS after applying program update 


service, corrective service, or local service. 


Should You Be Doing This Now? 


e If you are also servicing CP, you must apply the service to CP before rebuilding CMS. See Chapter 13, 
“Applying Service to CP” on page 429. 


e Otherwise, continue with this chapter. 
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Step 1. Build a New CMS Macro Library 


Note: This step describes a method of updating the CMS macro libraries that isolates all of the serviced 


macros and control blocks into a separate MACLIB using the VMFMAC EXEC. The new 
MACLIB ts added to the MACS record in the DMSMXA CNTRL file. 


An alternate method of updating the CMS macro libraries is to update each affected MACLIB 


with the changed macro or control block by using the MACLIB command. (See VM/XA SP 
CMS Command Reference for details on the MACLIB command.) 


If you choose the alternate method of building new CMS macro libraries, do so now and continue 
with “Step 2. Build a New CP Macro Library” on page 435. 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cms Hf 


2. Determine the macros and control blocks you have service for: 
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Search the DELTA string for all macros and control blocks you have service for: 


listfile * E*DS fml (exec args fname Wf fm is the alternate DELTA (593) disk. 

listfile * E*DS fm2 (append args fname fm2 is the intermediate alternate DELTA (691) 
disk. 

listfile * E*DS fm3 (append args fname @ m3 is the current DELTA (293) disk. 


If a CMS EXEC does not exist on your A-disk after these commands, no serviced macros or control 
blocks were found on the DELTA string. Continue with substep 3. 


Save the filenames in the CMSUPDAT EXEC and erase the CMS EXEC: 


copyfile cms exec a cmsupdat = = (replace @ 
erase cms exec a Hf 


Determine which of the updated files are macros (filetype MACRO), and which are control blocks 
(filetype COPY). Store the results in the CMSNEW EXEC: 


cmsupdat listfile % macro * (append args ftype @ 
cmsupdat listfile % copy * (append args ftype Mlgnore the messages that appear on your screen 
while these two commands are processing. 


If a CMS EXEC does not exist on your A-disk after these commands, no serviced macros or control 
blocks were found on the DELTA string. Continue with substep 3. 
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e Save the filenames in the CMSNEW EXEC: 


copyfile cms exec a cmsnew = = (replace @ 


e Edit the CMSNEW EXEC to remove any duplicate entries: 


xedit cmsnew exec 
sort * 115 @ 


file i 


3. Determine the macros and control blocks for which you have local service. Follow your installation’s 
naming conventions for locally serviced files. Locally serviced files should reside on the LOCALI disk 
string. 


e Ifno macros and control blocks have local service, continue with substep 4. 


e Otherwise, add your locally serviced macros and control blocks to CMSNEW EXEC. When you are 
done, the CMSNEW EXEC should list all macros and control blocks for which you have received 
IBM service (if any), plus any macros and control blocks for which you have local service. 


If you do not have a CMSNEW EXEC on your A-disk, copy the DMSGPI EXEC to use as a 


template: 


copyfile dmsgpi exec fm cmsnew = a (recfm f lrecl 80 @ 


If you created the CMSNEW EXEC by copying the DMSGPI EXEC, use the contents of the 
DMSGPI EXEC only for a guide to the format of the entries. After you have added the macro and 
control block names you need, in the proper format, delete the macro names that originated from the 
DMSGPI EXEC: 


xedit cmsnew exec a 
file Hi 


4. If you have no updated macros or control files at this point, continue with “Step 2. Build a New CP 
Macro Library” on page 435. 


5. Generate the new macro library on your A-disk (191) by using the VMFMAC EXEC: 


vmfmac cmsnew dmsmxa Wl DMSMXA CNTRL is a special control file used 
DMSUPD178I Updating macroname MACRO fim for generating CMS macro libraries. Do not 
DMSUPD178I Applying macroname update fm confuse it with DMSXA CNTRL, the CMS main 
macroname MACRO ADDED control file. 


Ready; T=n.nn/n.nn hh:mm:ss 


6. The contents of CMSNEW COPY were appended to CMSNEW MACLIB. You can now erase 
CMSNEW COPY (a file created by VMFMAC) on your A-disk (191): 


erase cmsnew copy a Hf 
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7. Add the new macro library name to the TEXT MACS card in the DMSXA CNTRL file. (DMSXA 
CNTRL is the the CMS main control file. Do not confuse it with DMSMXA CNTRL, used for 
generating CMS macro libraries.) 


List the new macro library first so that you use the updated macros. If you have already done this 
during previous service to CMS, you do not have to do this now. 


xedit dmsxa cntr] fm @ fmis the CMS alternate BUILD1 disk (490). 
locate/TEXT MACS @ 

TEXT MACS maclib ... 

change/MACS/MACS CMSNEW/ @ 

TEXT MACS CMSNEW maclib ... 

file 


8. Copy the changed files from your A-disk to the CMS database: fm is the alternate DELTA disk (593) if 
you have no local service to the macros or control blocks. fm is the alternate LOCAL disk (395) if you 
have any local service to the macros or control blocks. 


copyfile cmsnew exec a = = fm (olddate replace @ 
copyfile cmsnew maclib a = = fm (olddate replace @ 


9. To make the MACLIB you just created available to general users, copy it from the CMS database to 
your CMS alternate BUILD] disk (490): 


copyfile cmsnew maclib origin-fm = = target-fm2 (olddate replace Ml 
origin-fm is the disk you copied the changed files 


to in the previous substep. target-fm is the CMS 
alternate BUILD1 disk (490). 


10. Erase the working copies on your A-disk: 
erase cmsnew exec a @ 


erase cmsupdat exec a @f 
erase cmsnew maclib a @ 
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Step 2. Build a New CP Macro Library 


Note: This step describes a method of updating the CP macro libraries that isolates all of the serviced 


macros and control blocks into a separate MACLIB using the VMFMAC EXEC. The new 
MACLIB 1s added to the MACS record in the HCPXA CNTRL file. 


An alternate method of updating the CP macro libraries is to update each affected MACLIB with 
the changed macro or control block by using the MACLIB command. (See VM/XA SP CMS 
Command Reference for details on the MACLIB command.) 


If you choose the alternate method of building new CP macro libraries, do so now and continue 
with “Step 3. Update the CMS Message Repository” on page 438. 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cp @ 


2. Determine the macros and control blocks you have service for: 


Search the DELTA string for all macros and control blocks you have service for: 


listfile * A*HP fml (execs args fname @ fm! is the alternate DELTA (594) disk. 

listfile * A*HP fm2 (append args fname Mf fm2 is the intermediate alternate DELTA (591) 
disk. 

listfile * A*HP {m3 (append args fname @ fm3 is the current DELTA (294) disk. 


If a CMS EXEC does not exist on your A-disk after these commands, no serviced macros or control 
blocks were found on the DELTA string. Continue with substep 3. 


Save the filenames in the CPUPDATE EXEC and erase the CMS EXEC: 


copyfile cms exec a cpupdate = = (replace @ 
erase cms execa 


Determine which of the updated files are macros (filetype MACRO), and which are control blocks 
(filetype COPY). Store the results in the CPNEW EXEC: 


% macro * (append args ftype @ 
% copy * (append args ftype MiIgnore the messages that appear on your screen 
while these two commands are processing. 


cpupdate listfil 
cpupdate listfil 


mo om 


Ifa CMS EXEC does not exist on your A-disk after these commands, no serviced macros or control 
blocks were found on the DELTA string. Continue with substep 3. 
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Save the filenames in the CPNEW EXEC: 


copyfile cms exec a cpnew = = (replace @ 


Edit the CPNEW EXEC to remove any duplicate entries: 


xedit cpnew exec Mf 
sort * 115 @ 


file @ 


3. Determine the macros and control blocks for which you have local service. Follow your installation’s 


naming conventions for locally serviced files. Locally serviced files should reside on the LOCAL] disk 
string. 


If no macros and control blocks have local service, continue with substep 4. 


Otherwise, add your locally serviced macros and control blocks to CPNEW EXEC. When you are 
done, the CPNEW EXEC should list all macros and control blocks for which you have received IBM 
service (if any), plus any macros and control blocks for which you have local service. 


If you do not have a CPNEW EXEC on your A-disk, copy the HCPGPI EXEC to use as a template: 


copyfile hcpgpi exec fm cpnew = a (recfm f Irecl 80 @ 


If you created the CPNEW EXEC by copying the HCPGPI EXEC, use the contents of the HCPGPI 
EXEC only for a guide to the format of the entries. After you have added the macro and control 
block names you need, in the proper format, delete the macro names that originated from the 
HCPGPI EXEC: 


xedit cpnew exec a & 


file 


4. If you have no updated macros or control files at this point, continue with “Step 3. Update the CMS 


Message Repository” on page 438. 
. Generate the new macro library on your A-disk (191) by using the VMFMAC EXEC: 
vmfmac cpnew hcpmxa 


DMSUPD178I Updating macroname MACRO fm 
DMSUPD1781 Applying macroname update fim 


macroname MACRO ADDED 


Ready; T=n.nn/n.nn hh:mm:ss 


6. The contents of CPNEW COPY were appended to CPNEW MACLIB. You can now erase CPNEW 
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COPY (a file created by VMFMAC) on your A-disk (191): 


erase cpnew copy a Mf 
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7: 


9. 


10. 


Add the new macro library name to the TEXT MACS card in the HCPXA CNTRL file. 


List the new macro library first so that you use the updated macros. If you have already done this 
during previous service to CP, you do not have to do this now. 


xedit hcpxa cntrl fm fm is the CP BASE] disk (194). 
locate/TEXT MACS @ 

TEXT MACS maclib ... 

change/MACS/MACS CPNEW/ @& 


TEXT MACS CPNEW maclib ... 
file i 


. Copy the changed files from your A-disk to the CP database: fm is the alternate DELTA disk (594) if 


you have no local service to the macro or copy files. fm is the alternate LOCAL disk (295) if you have 
any local service to the macro or copy files. 


copyfile cpnew exec a = = fm (olddate replace @ 
copyfile cpnew maclib a = = fm (olddate replace @ 


To make the MACLIB you just created available to general users, copy it from the CP database to your 
CMS alternate BUILD1 disk (490): 


copyfile cpnew maclib origin-fm = = target-fm2 (olddate replace @ 


origin-fm is the disk you copied the changed files 
to in the previous substep. target-fm is the CMS 
alternate BUILD1 disk (490). 


Erase the working copies on your A-disk: 
erase cpnew exec a Hf 


erase cpupdate exec a Hf 
erase cpnew maclib a @ 
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Step 3. Update the CMS Message Repository 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cms Hf 


2. Determine your system default national language: 


query lang @ 


langid See Table 5 on page 311 to identify the language 
corresponding to /angid. Note the country code 
for that language. 


3. Invoke the VMFNLS EXEC to update the CMS message repository: 


vmfnis dmsmesy repos 56643089 cms @ y 1s the country code for your system national 
Ready; T=n.nn/n.nn hh:mm:ss language. 


4. If you have updates to the message repositories for any other national languages installed on your 
system, repeat substep 3 for each language. 


5. Copy the changed files from your A-disk to the CMS database: fm is the alternate DELTA disk (593) if 
you have no local service to the macro or copy files. fm is the alternate LOCAL disk (395) if you have 
any local service to the macro or copy files. 


copyfile dmsmesy {text|txtnnnnn} a = = fm (olddate replace Mf 
copyfile dmsmesy listing a = = fm (olddate replace Mf 


6. Erase the working copies on your A-disk: 


erase dmsmesy {text|txtnnnnn} a 
erase dmsmesy listing a Mf 
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Step 4. Assemble the Changed ASSEMBLE Files 


Do this step if you have local modifications to ASSEMBLE files. 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cms 


2. Use the list of parts for which you have both local modifications and IBM service that you made in 
Chapter 2, “Applying Service to CMS.” You must reassemble any such ASSEMBLE files to pick up the 
local updates. 


3. Copy and unpack the ASSEMBLE files you need to reassemble from the CMS current BASE2 disk (393) 
to your A-disk: 


copy dmsxxx assemble fm = = a (unpack olddate Mi Substitute the last 3 characters of the filename of 
Ready; T=n.nn/n.nn hh:mm:ss the ASSEMBLE file for xxx. 


4. Use the VMFHASM EXEC to update and assemble all the files for which you have both IBM service 
and local modifications: 


vmfhasm dmsxxx 56643089 cms Substitute the last 3 characters of the filename of 
DMSUPD178I UPDATING DMSxxx ASSEMBLE filemode the ASSEMBLE file for xxx. 


DMSUPD1781 APPLYING DMSxxx filetype filemode If you assemble DMSNUC ASSEMBLE, you may 
ASSEMBLING DMSxxx receive some assembler warning messages and a 
DMSxxx {TEXT|xxxnnnnn} CREATED return code of 4. The warnin : and cae code 
PRT FILE nnnn SENT FROM MAINT PRT AS nnnn ee eae e 

are normal: you can ignore them. However, the 


Pee) ORE EO am MOREEr §=— PNAS Gent deck vou create evalid. 
Ready; T=n.nn/n.nn hh:mm:ss 


5. Copy all the text files from the A-disk to the alternate LOCALI1 (395) disk: 


copy dmsxxx {text|xxxnnnnn} a = = fm (replace olddate Bi 


6. If you reassembled any files that are not in the CMS load list (CMSLOAD EXEC), copy the text decks 
to the alternate LOCALI disk again, giving the copy the filetype TEXT: 


copy dmsxxx {text|xxxnnnnn} a = text fm (replace olddate 


7. Erase all the ASSEMBLE files and text files on your A-disk: 


erase dmsxxx assemble a Wf 
erase dmsxxx {text|xxxnnnnn\} a @ 


8. Repeat substeps 3 through 7 for each file that must be reassembled. 
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| Step 5. Build the New Product Parameter File 


| Do this step if the 56643089 $PPF file has been serviced. 


1. Establish the correct minidisk access order: 


vmfsetup 56643089 cms @ 
DMSACC724I vdevno replaces fm (vdevno 


| ° 
| Ready; T=n.nn/n.nn hh:mm:ss 


ho 


Look for the latest version of the product parameter file: 


| filelist 56643089 $p* * Examine each version of the product parameter 

| file. The product parameter file has an update 

| history at the top. The latest level is the one with 
| the most updates. Use the update history, not the 
| date and time stamp, to determine which is the 

| most recent version. 


| 3. Copy the latest level of the product parameter file to the TASK disk (SES): 
copyfile / = $ppf fm (olddate replace @ Issue this command from the FILELIST screen, 


| 
| Ready; T=n.nn/n.nn hh:mm:ss on the line listing the file you want to copy. fm is 
| the TASK disk (SES). 
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Step 6. Build the CMS Nucleus 


Warning: Before you run VMFBLD, you must rebuild the CMS build lists if they have been serviced. The 
complete list of CMS build lists is found in the :BLD. section of the CMS portion of the PPF. 


Use the procedures in “Step 8. Regenerate System Product Interpreter Programs” on page 449 to rebuild 
the build lists, and return here. 


1. Spool punch output to your own virtual reader: 


spool punch * @ 
Ready; T=n.nn/n.nn hh:mm:ss 


2. Generate the new CMS nucleus: 


vmfbld 56643089 cms (punch Mf This invokes the VMFBLD EXEC to build a new 
LOAD LIST: $$$TLL$$ EXEC Al (MNT191) nucleus for CMS. The VMFBLD EXEC performs 
; a number of system generation functions for you. 


For more information on this EXEC, see 
“VMFBLD EXEC” on page 652. 


RDR FILE fileno SENT FROM MAINT PUN AS fileno The system loader punches the CMS nucleus. 


RECS nnnn COPY 001 N NOHOLD NOKEEP This message tells you that the punch file 1s 
complete. 
Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be that a 


PTF now being applied has another PTF. outside 
CMS, as a prerequisite. Check the SVMFBLD 
SERRLOG file for message DMSBNC1854W. 


3. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build @ 


4. Ensure that the proper files are in the virtual reader: 


query rdr * all @ The ALL operand requests a display of all 
information about the reader files. 

ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT = nnnn * PUN nonnnnnn 001 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 


Ready; T=n.nn/n.nn hh:mm:ss 


5. Order your reader so that the CMS nucleus will be processed first: 


order rdr fileno @ fileno is the file number of the CMS nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 
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6. Ensure that the virtual reader is readied for class * reader files: 


10. 


query virtual 00c @ 

RDR @00C CL cl NOCONT NOHOLD' EOF READY 
Q@0C 2540 CLOSED NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 


. If the virtual reader is not class * issue: 


spool rdr class * keep @ The KEEP option places the spool file in USER 

Ready; T=n.nn/n.nn hh:mmiss HOLD status after it has been read. To remove 
this file from your reader, issue purge rdr_fileno, 
where fileno is the file number of the reader file. 


. IPL your virtual reader: 


ip] 00c @ 
DMSINS327I The installation saved segment could not be loaded 


Informational message: The CMSINST 
installation segment has not been loaded and 


saved yet. 
VM/XA ALTCMS mm/dd/yy The version identification you defined appears 
a here and each time that you IPL 490 or IPL CMS. 
Ready; T=n.nn/n.nn hh:mm:ss The ready message indicates that the nucleus has 


been loaded to your 490 minidisk successfully. 


. Receive the CMS load map into your reader: 


spool prt * nohold 
close prt * Hf 


Query the reader to identify the CMS load map: 


query rdr * all 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 
MAINT  fileno M PUN nnonnnnnn 001 NONE mm/dd hh:mm:ss SYSPROG 


The CMS load map is the file with a blank 
filename and filetype. It has approximately 8,100 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUP level. Note the fileno of this file. You 
will use it in your next command. 
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vmfsetup 56643089 cms The CMS load map is loaded on the alternate 
receive fileno fn ft fm @ LOCAL] (395) minidisk. 
fn ft fml created 
DMSRDC738I Record length is 132 bytes 
File fn ft fm received from MAINT at 
nodeid as fn ft fm 
Ready; T=n.nn/n.nn hh:mm:ss 


You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as |—9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 


11. Review the CMS load map to verify that any local modifications to CMS modules have been applied. 


Note: From this point on: 


¢ To IPL your production system, issue: 
ip] 196 & 


¢ To IPL your test system, issue: 
ip] 496 & 
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Step 7. Generate Executable Modules 


l. 


2. 
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Establish the appropriate minidisk access order: 


vmfsetup 56643089 cms @ 


Regenerate any MODULEs and LOADLIBs for which you have received IBM service: 


e Make and sort a list of the files you are servicing: 


listfile * text fm (exec Ml fm is the alternate DELTA disk (593). 
listfile * text fm (append fm is the LOCAL] disk (395). 

rename cms exec a dmstext = = The exec option saves the list in a file called 
xedit dmstext exec CMS EXEC. Any previously existing CMS 
sort * 115 @ EXEC on your A-disk is erased. 

file @ 


e Check this list against Table 12. You must generate an executable module for any file you find 
listed there. 


e Find each executable module you have to regenerate in the first column of the table. Enter the 
command in the second column. Make sure that the file named in the third column is created on 
your A-disk. You can ignore any INVALID CARD messages you receive while running CMSGEND. 


During regeneration of the modules in Table 12, files with a filetype of LKEDIT may be created and 
erased. You do not need them. 


Table 12 (Page | of 4). CMSGEND Files 


Assemble 
Filename Command to Enter File Created by This Command 


Note: If you receive service for a CMS text deck not listed in this table, it will be regenerated in 
some other way. You do not need to regenerate it now. (See Table 15 on page 567 in 
Appendix A, “VM/XA System Product Regeneration Requirements” for the procedure used. 
Text decks not listed in this table, or in Table 15 on page 567, become part of the nucleus 

when the system is built if they are listed in the CMS load list.) 


DMSAMS cmsgend amserv @ AMSERV MODULE 
DMSASD cmsgend assemble @ ASSEMBLE MODULE (see 
DMSASM Note 5 on page 447) 
DMSASN cmsgend assgn @ ASSGN MODULE 
DMSBCT cmsgend dmsdft @ DMSDFT MODULE 
DMSBLG 

DMSCDI 

DMSDFT 

DMSSMG 

DMSUSR 
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Table 12 (Page 2 of 4). CMSGEND Files 


Assemble 

Filename Command to Enter File Created by This Command 
DMSBOF cmsgend dmscut DMSCUT MODULE 
DMSBUS 

DMSCCM 

DMSCIA 

DMSICT 

DMSPBS 

DMSSAP 

DMSSNC 

DMSSUP 

DMSTRC 

DMSBTB cmsgend cmsbatch CMSBATCH MODULE 
DMSCCK cmsgend catcheck @ CATCHECK MODULE 
DMSCMP cmsgend compare Mf COMPARE MODULE 
DMSDLK cmsgend doslked Mf DOSLKED MODULE 
DMSDSK cmsgend disk @ DISK MODULE 
DMSDSL cmsgend doslib @ DOSLIB MODULE 
DMSDSV cmsgend dsery & DSERV MODULE 
DMSEDC cmsgend edit EDIT MODULE (see Note | 
DMSEDF on page 447) 

DMSEDI 

DMSEDX 

DMSGIO 

DMSSCR 

DMSZIT 

DMSEXG cmsgend dessgen @ DCSSGEN MODULE 
DMSEXM cmsgend execmap EXECMAP MODULE 
DMSFOR cmsgend format @ FORMAT MODULE 
DMSGLB cmsgend global @ GLOBAL MODULE 
DMSGND cmsgend gendirt @ GENDIRT MODULE 
DMSHLB cmsgend helpconvy @ HELPCONV MODULE 
DMSHLD 

DMSHLI 

DMSHLP 

DMSHLS 

DMSICP emsgend iocp Hf IOCP MODULE 
IOPCxxxx 

IOPPxxxx 

DMSIMA cmsgend imagemod IMAGEMOD MODULE 
DMSLBD cmsgend labeldef Mi LABELDEF MODULE 
DMSLBM cmsgend maclib @ MACLIB MODULE 
DMSLBT cmsgend txtlib Mf TXTLIB MODULE 
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Table 12 (Page 3 of 4). CMSGEND Files 


Assemble 

Filename Command to Enter File Created by This Command 

DMSLDS cmsgend listds LISTDS MODULE 

DMSLLU cmsgend listio LISTIO MODULE 

DMSLMX cmsgend tape TAPE MODULE (see Note 2 
on page 447) 

DMSMDP cmsgend modmap MODMAP MODULE 

DMSMGC cmsgend genmsg @ GENMSG MODULE 

DMSMGD 

DMSMGE 

DMSMIG cmsgend macimig MACLMIG MODULE 

DMSMVE emsgend movefile @ MOVEFILE MODULE 

DMSNXD cmsgend nucxdrop NUCXDROP MODULE 

DMSOPT cmsgend option OPTION MODULE 

DMSOSR cmsgend osrun B OSRUN MODULE 

DMSOVR cmsgend syctrace @ SVCTRACE MODULE 

DMSOVS cmsgend dmsoys DMSOVS MODULE 

DMSPCA cmsgend dmspcec & DMSPCC MODULE 

DMSPCB 

DMSPCC 

DMSPCR 

DMSPCT 

DMSPCW 

DMSPOA cmsgend prop PROPLIB LOADLIB (see Note 

DMSPOC 3 on page 447) 

DMSPOD 

DMSPOE 

DMSPOL 

DMSPON 

DMSPOP 

DMSPOQ 

DMSPOR 

DMSPOS 

DMSPRE cmsgend preload @ PRELOAD MODULE 

DMSPRV cmsgend pservy PSERV MODULE 

DMSPUN cmsgend punch & PUNCH MODULE 

DMSRDC cmsgend readcard READCARD MODULE 

DMSRDR cmsgend rdr @ RDR MODULE 

DMSRNE cmsgend renum @ RENUM MODULE 

DMSRRV cmsgend rsery & RSERV MODULE 

DMSRSV cmsgend reserve RESERVE MODULE 

DMSSFD cmsgend savefd SAVEFD MODULE 
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Table 12 (Page 4 of 4). CMSGEND Files 


Assemble 

Filename Command to Enter File Created by This Command 

DMSSPR cmsgend setprt @ SETPRT MODULE 

DMSSRT cmsgend sort @ SORT MODULE 

DMSSRV cmsgend ssery SSERV MODULE 

DMSSSK cmsgend setkey SETKEY MODULE 

DMSSYN cmsgend synonym @ SYNONYM MODULE 

DMSTMA cmsgend tapemac TAPEMAC MODULE 

DMSTPD cmsgend tappds @ TAPPDS MODULE 

DMSTPE cmsgend tape @ TAPE MODULE (see Note 2 

DMSTPF on page 447) 

DMSTPG 

DMSTPH 

DMSTPI 

DMSTPJ 

DMSTYP cmsgend type Mf TYPE MODULE 

DMSUPD cmsgend update UPDATE MODULE 

DMSUTL cmsgend loadlib @ LOADLIB MODULE 

DMSXMS cmsgend dmsxms DMSXMS MODULE (see | 
Note 4 on page 447) 

DMSXRE cmsgend dmsxre @ DMSXRE MODULE (see Note 
4 on page 447) 

DMSZAP cmsgend zap @ ZAP MODULE 

VMFCLEAR sioad vmfclear (origin trans nomap type @ VMFCLEAR MODULE 

genmod vmfclear module a (nomap system nostr 
all 

VMFDATE cmsgend vmfdate VMFDATE MODULE 

VMFDOS cmsgend vnfdos M VMFDOS MODULE 

VMFLOAD cmsgend vmfload @ VMFLOAD MODULE 

Notes: 


1. When the CMSGEND EXEC procedure is invoked for EDIT, it creates the EDIT module. Then 
it automatically reinvokes itself to create the EDMAIN module. 


2. When the CMSGEND EXEC is invoked for TAPE, it creates the TAPE module and then 
reinvokes itself to create the DMSLMX and DMSTPx modules. 


3. You get messages DMSSLKO0008W and DMSSOP036E when you regenerate PROPLIB. You 
can ignore them. 


4. All EDIT source files, except DMSXMS and DMSXRE, are contained within the CMS nucleus. 


5. The assembler text decks normally reside on the system S-disk as filemode S1. This disk must be 
accessed as some additional filemode before you issue the CMSGEND ASSEMBLE command in 
order to locate these files. Refer to “CMSGEND EXEC” on page 577. 
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3. Test the modules. 
4. Copy any MODULEs and LOADLIBs generated on the A-disk to the alternate DELTA disk. Then 
erase them on the A-disk: 


copyfile fn MODULE|LOADLIB A = = fm @ fm is the alternate DELTA disk (593). 
erase fn MODULE|LOADLIB A @ 


5. Copy all serviced MODULES to their appropriate build disks: 
e Create a list of the MODULEs you are servicing. 
Note: This list includes all serviced MODULES on the alternate DELTA disk whether or not you 


regenerated them in the previous step. 


filelist * MODULE fm @ fm is the alternate DELTA disk (593). 


e Create a list of all parts for each filename in the filelist by pressing PF9. Press PF9 for each file in 
the original filelist. 


e Copy the new executable version of the module to the appropriate build disks: 


— If an executable version (with filetype MODULE) exists on the BUILD! disk, copy the new 
version there. 


— If an executable version exists on the TASK disk, copy the new version there. 
— If an executable version does not reside on one of these disks, refer to the documentation 


supplied with the PTF to determine where it should reside. 


copyfile / = = fm2 (olddate replace Ml Enter this command on the filelist screen next to 
the file you want to copy. You are copying 
these files from the alternate DELTA disk (593) 
to the BUILD1 disk (490), the TASK disk 
(SES), or both. 


Use filemode 2 for files copied to the BUILD 1 
disk so they can be seen by other users. 


e Press PF2 to refresh the screen to verify that your changes have been made. 
e When you have processed each file in the original filelist screen, use PF3 to exit filelist. 


6. Repeat substep 5 for LOADLIBs. 
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Step 8. Regenerate System Product Interpreter Programs 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cms Mi 


2. Regenerate any EXECs and XEDIT macros for which you have received IBM service and for which you 
have local modifications. (If you have none, go to substep 3). 


Use the list of parts for which you have both local modifications and IBM service that you made in 
Chapter 12, Applying Service to CMS. 


If you reworked or kept your local modifications, you must now regenerate the EXECs and XEDIT 
macros. Repeat the following three commands for each file that needs to be regenerated. 


Note: ff is either EXEC or XEDIT. Remember to include the leading dollar sign ($) when it 1s 
specified. 


copyfile fn $ft origin-fm = = destination-fm MI origin-fm is the BASE2 disk (393). 
destination-fm is the alternate DELTA disk 
(593). 


The file is copied to the alternate DELTA disk 
because the EXECUPDT command puts the 
object file on the same disk as the source file. 


execupdt fn ft fm (ctl dmsxa hist option @ DMSXA is the CMS control filename. 


For any files with a SID code in columns 
63-71, use the SID option. The following files 
do not include SID codes: 


PROPEPIF EXEC 
PROPHCHK EXEC 
PROPLGER EXEC 
PROPPCHK EXEC 
PROPPROF EXEC 
PROPRTCV EXEC 
PROPST EXEC. 


erase fn $ft fm fm is the alternate DELTA disk (593). 


3. Copy all serviced EXECs to their appropriate build disks: 


Create a list of the EXECs you are servicing. 


Note: This list includes all the serviced EXECs on your alternate DELTA disk whether or not you 
regenerated them in the previous step. 


filelist * EXEC fm @ fms the alternate DELTA disk (593). 


Create a list of all parts of each filename in the filelist using PF9. Press PF9 for each file in the 
original filelist. 
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e Identify the latest version of the EXEC: 


If you just regenerated the EXEC in the previous step, you already have the latest level. 


If you did not regenerate the EXEC, use the associated AUX files to determine the latest PTF 
against the given EXEC. This PTF number is the top one in the AUX file. Locate the 
PTF-numbered version of the EXEC (with filetype EXCnnnnn, where nnnnn is the PTF number). 
This PTF-numbered version of the EXEC is the version you want to use. 


If the EXEC is not maintained with updates, it will not have any associated AUX files and you 
have to use the internal documentation in the EXEC to determine the PT F-numbered version to 
use. Do not depend on date and time stamps; examine the actual files. Each file ends with an 
update summary that indicates the file’s service history. The latest version is the one with the 
most service. Files with filetypes of EXCnnnnn, and XEDnnnnn are exact images of the 
corresponding EXEC and XEDIT executables. 


¢ Copy the PTF-numbered version that you just selected to its executable filetype on the alternate 
DELTA disk. This step does not apply to those EXECs that you regenerated with the EXECUPDT 
command. 


copyfile / = EXEC fm (olddate replace @ Enter this command on the filelist screen next to 


the file you want to copy. /m is the alternate 
DELTA disk (593). 


Press PF2 to refresh the screen to verify that your changes have been made. 


Copy the new executable version of the module to the appropriate build disks: 


If an executable version (with filetype EXEC) exists on the BUILD1 disk, copy the new version 
there. 


If an executable version exists on the TASK disk, copy the new version there. 


If an executable version does not reside on one of these disks, refer to the documentation 
provided with the PTF to determine where it should reside. 


copyfile / = = fm2 (olddate replace Mf Enter this command on the filelist screen next to 


the file you want to copy. You are copying 
these files from the alternate DELTA disk (593) 
to the BUILD! disk (490), the TASK disk 
(SE5), or both. 


Use filemode 2 for files copied to the BUILD] 
disk so they can be seen by other users. 


Press PEF2 to refresh the screen to verify that your changes have been made. 


Return to the original filelist screen, using PF3. 


¢ When you have processed each file in the original filelist screen, use PF3 to exit filelist. 


| 4. Repeat substep 3 for XEDIT macros. Replace EXEC with XEDIT and EXCnannnn with XEDnnnnn. 
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Step 9. Create Test EXECs and Files 


In this step, you will create the EXECs and files needed to establish test named saved systems and saved 
segments. 


| 1. Establish the appropriate minidisk access order: 


| vmfsetup 56643089 cms 


2. Choose temporary names for all your new named saved systems and saved segments so that you do not 
overlay those you are working with until you are satisfied that the new ones work. This sample procedure 
uses the following names: 


Real Name Temporary Name 
CMS ALTCMS 
CMSXA ALTCMSXA 
DOSBAM ALTDSBAM 
DOSINST ALTDOSIN 
CMSDOS ALTDOS 
CMSBAM ALTBAM 
CMSVSAM ALTVSAM 
CMSAMS ALTAMS 
INSTHELP ALTINSHP 
CMSINST ALTINST 
HELP ALTHELP 
GCS ALTGCS 


3. Copy the SAMPNSS EXEC: 


| vmfsetup 56643089 cms Hi 
copy sampnss exec fm testnss = = Hf 


4. Edit the TESTNSS EXEC, changing all the real names to temporary names: 


xedit testnss exec 


When you have finished, the TESTNSS EXEC should look like this: 


[ REAPLEAER TER RENS ERASER AR RERA SALE LANA ASSN RAE SRR RE CRS 


| os Virtual Machine / System Product 5664-308 i | 
has Contains restricted materials of IBM sat 
yea Copyright (c) I BM Corporation 1988 anf 
| ais Licensed Materials - Property of I BM al 


je Refer to Copyright Instructions: Form G120-2083 ht | 
JPAOEEKELERE ERE SEA ALE REE AEE AA AERA AAR ERS SERA ERE RARE SAA AAAS ORE 
arg parml parm2 
Address Command 
Select 
when parml = 'ALTCMS' & parm2 = 'ALTCMSXA' then 
do; 
‘CP DEFSYS ALTCMS  0- 
‘CP DEFSYS ALTCMSXA 0- 
end; 


EW 20-22 EW EQO-FFF SR MINSIZE=256K' 
EW 


A 
A 20-22 EW EOO-FFF SR MINSIZE=256K'’ 
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WHEN PARM1 = 'ALTGCS' THEN 
‘CP DEFSYS ALTGCS 0-6 EW 400-5FF SW MINSIZE=256K VMGROUP RSTD' 
when parml = 'ALTINST' then 
'CP DEFSEG ALTINST COO-C4F SR SPACE ALTINSHP' 
WHEN PARM1 = 'ALTHELP' THEN 
'CP DEFSEG ALTHELP C50-C9F SR SPACE ALTINSHP' 
WHEN PARM1 = 'ALTDOS' THEN 
'CP DEFSEG ALTDOS BOO-BOF SR SPACE ALTDSBAM' 
WHEN PARM1 = ‘ALTBAM' THEN 
'CP DEFSEG ALTBAM B10-B3F SR SPACE ALTDSBAM' 
WHEN PARM1 = 'ALTVSAM' THEN 
'CP DEFSEG ALTVSAM BAOQ-BFF SR A30-A3F EW SPACE ALTDSBAM' 
WHEN PARM1 = 'ALTAMS' THEN 
‘CP DEFSEG ALTAMS B40-B9F SR AOQ-A2F EW SPACE ALTDSBAM' 
Otherwise 
do; 
say ‘Unrecognized Parameters passed - ' parml parm2 
end; 
End /* Select */ 
‘CP QUERY NSS ALL' 
Exit 


5. File the TESTNSS EXEC: 


file i 


6. Copy the latest version of the SAMGEN EXEC: 


copy samgen exec fm altsamgn = = Hf 


7. Edit the ALTSAMGN EXEC, changing CMSBAM to ALTBAM throughout: 


xedit altsamgn exec Ml 
change/CMSBAM/ALTBAM/* * 
file 


8. Copy CMSBAM MAP and CMSBAM DOSLIB as ALTBAM MAP and ALTBAM DOSLIB: 


copy cmsbam map fm altbam = = Mf 


copy cmsbam doslib fm altbam = = 


9. Copy the latest version of the VSAMGEN EXEC: 


copy vsamgen exec fm altvsamg = = 


10. Edit the ALTVSAMG EXEC, changing CMSVSAM to ALTVSAM, and CMSAMS to ALTAMS 
throughout: 


xedit altvsamg exec 
change/CMSVSAM/ALTVSAM/* * i 
top # 
change/CMSAMS/ALTAMS/* * 
file 
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ll. 


Copy all files with a filename of CMSVSAM, CMSAMS, or CMSAMSx giving the copies filetypes of 
ALTVSAM, ALTAMS, and ALTAMSx: 


filelist cmsvsam * * 


copy cmsvsam ft fm altvsam = = @& 
filelist cmsams* * * Hf 

copy cmsams ft fm altams = = @ 
copy cmsamsx ft fm altamsx = = & 


. You may have created a load list for the DCSSGEN command during the installation process. The one 


created in the sample installation process was called INSTLIST FILE. It should be on your A-disk 
(191). Ifit is not there, you probably used the IBM-supplied load list. This load list is called CMSINST 
EXECLIST. It should be on your 193 disk. Copy one of these load lists as ALTINST EXECLIST: 


copy fn ft fml altinst execlist fm2 Hl fm? is the 193 disk. 
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Step 10. Build Test Named Saved Systems 


I. 


bo 


Use the TESTNSS EXEC to define segments and save your new CMS and CMSXA: 


testnss altcms altcmsxa Wf The TESTNSS EXEC issues the DEFSYS 
command. 
HCPNSD440I1 The Named Saved System (NSS) ALTCMS Note: The names are positional on the TESTNSS 
was successfully defined in fileid command (the System/370 name followed 
fileno. by the 370-XA name). 


HCPNSD440I The Named Saved System (NSS) ALTCMSXA 
was successfully defined in fileid 
fileno. 


The TESTNSS EXEC first issues the DEFSYS 
command.-to define a skeleton system data file for 
ALTCMS and for ALTCMSXA. These messages 
tell you the DEFSYS commands were successful. 


OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nann NSS) S— nnnn mm/dd hh:mm:ss ALTCMS NSS MAINT 
*NSS nonn NSS S_— nnnn mm/dd hh:mm:ss ALTCMSXA NSS MAINT 


Ready; T=n.nn/n.nn hh:mm:ss 
The TESTNSS EXEC issues a QUERY NSS 
command. These messages show what system 
data files are defined. 


. Issue the QUERY NSS ALL MAP command to make sure ALTCMS 1s defined properly. Verify that 


the information under BEGPAG, ENDPAG, TYPE, and CL in the response to QUERY NSS ALL 
MAP 1s the same as shown. 


query nss all map @ 
FILE FILENAME FILETYPE MINSIZE BEGPAG ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


nnnn ALTCMS ~ NSS 000256K QO0000 OOOOA EW S$ O0000 OMITTED NO 
00020 00022 EW 
QOEOO OOFFF SR 

nnnn ALTCMSXA NSS 000256K O0000 OOQOOA EW S 00000 OMITTED NO 
00020 00022 EW 
QOEOO OOFFF SR 


. Set your machine mode to 370, load CMS (IPL 490), and save the ALTCMS system: 


set machine 370 Hi 


ip] 490 clear parm savesys altcms @ Load 490 with the option to save the system under 
the name ALTCMS. 


HCPNSS440I The named saved system ALTCMS was 
successfully saved in fileid fileno. 
VM/XA ALTCMS mm/dd/yy 


bs Press ENTER to initialize ALTCMS. 
Ready; T=n.nn/n.nn hh:mm:ss 
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4. Set your machine mode to XA, load CMS (IPL 490), and save the ALTCMSXA system: 


set machine xa @ 


ip! 490 clear parm savesys altcmsxa Mi Load 490 with the option to save the system under 
the name ALTCMSXA. 


HCPNSS440I The named saved system ALTCMSXA was 
successfully saved in fileid fileno. 
VM/XA ALTCMS mm/dd/yy 


a Press ENTER to initialize ALTCMSXA. 
Ready; T=n.nn/n.nn hh:mm:ss 


5. Set your machine mode to 370 (or XA), redefine your virtual storage to 2 megabytes, and load the 
ALTCMS (or ALTCMSXA) named saved system. The example below shows loading ALTCMS in 
System/370 mode: 


set machine 370 & 
define storage 2m 


STORAGE = 2M Defining storage causes a system reset. 
STORAGE CLEARED - SYSTEM RESET 

ipl altcms @ 

VM/XA ALTCMS mm/dd/yy 


a After receiving the version identification, press 
Ready; T=n.nn/n.nn hh:mm:ss ENTER to complete ALTCMS or ALTCMSXA 
initialization. 


6. Check the ALTCMS status by issuing QUERY NSS ALL and QUERY NSS ALL MAP. Verify that the 
information under FILENAME and FILETYPE in the response to QUERY NSS ALL is the same as 
shown. Also, verify that the information under BEGPAG, ENDPAG, TYPE, and CL in the response to 
QUERY NSS ALL MAP is the same as shown. The system data file should now have class A (rather 
than S) and have one user (MAINT). 


query nss all 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS ninn NSS A= nnnn mm/dd hh:mm:ss ALTCMS NSS MAINT 
*NSS nonn NSS A_—nnnn mm/dd hh:mm:ss ALTCMSXA NSS MAINT 


Ready; T=n.nn/n.nn hh:mm:ss 
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query nss all map @ 
FILE FILENAME FILETYPE MINSIZE BEGPAG ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


nonn ALTCMS = NSS 000256K O0000 OOO0A EW A 00001 OMITTED NO 
00020 00022 EW 
QOOEOO OOFFF SR 

nnnn ALTCMSXA NSS 000256K 00000 O000A EW A Q0000 OMITTED NO 
00020 00022 EW 
QOEOO OOFFF SR 


Ready; T=n.nn/n.nn hh:mm:ss 


From this point until you do Step 17, IPL your alternate (test) CMS system (ALTCMS or ALTCMSXA) 


instead of your current (production) CMS. 
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Step 11. Install Test CMSDOS, CMSBAM, CMSVSAM, and CMSAMS 
Saved Segments 


Warning: Do not skip this step even if you have not changed CMSDOS, CMSBAM, CMSVSAM, or 
CMSAMS. 


The test CMSDOS and CMSBAM segments must be installed before you install the test CMSVSAM and 
CMSAMS segments. 


1. Define your storage as 16 megabytes and IPL your new CMS system: 


define storage 16m & 

STORAGE = 0016M 

STORAGE CLEARED - SYSTEM RESET 

ip! altcms @ 

DMSINS327I The installation saved segment could not be loaded 


VM/XA ALTCMS mm/dd/yy This is a sample version header. 
** DO NOT press ENTER! ** 


access (noprof This command suppresses execution of MAINT’s 
PROFILE EXEC. 


2. Establish the appropriate minidisk access order: 


access 5£5 b 
access 193 e 


3. Issue: 
set emsg on @ You want to see any and all error messages during 
Ready; T=n.nn/n.nn hh:mm:ss execution of the installation EXEC. 


4. Define a segment into which the DOSGEN EXEC can load ALTDOS: 


defseg altdosin 900-90f sr I 


HCPNSD4401 Saved segment ALTDOSIN was This command defines a 1MB segment for 
successfully defined in fileid ALTDOSIN starting at 900000. You may place 
fileno this segment anywhere below the segment spaces 

Ready; T=n.nn/n.nn hh:mm:ss defined for ALTDOS, ALTBAM, ALTVSAM, 

and ALTAMS. 
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5. Invoke the DOSGEN EXEC with a load address and the name ALTDOSIN. The load address used for 
ALTDOSIN in this example is 900000. 


dosgen 900000 altdosin & 


HCPNSS440I Saved segment ALTDOSIN was The load address and name are those 
successfully saved in fileid recommended for the ALTDOSIN segment. Error 
fileno messages for the DOSGEN EXEC are listed on 


PRT FILE fileno SENT FROM MAINT PRT AS fileno page 459. 
RECS nann COPY 001 A NOHOLD NOKEEP 

DMSWGN715I DOSGEN COMPLETE 

Ready; T=n.nn/n.nn hh:mm:ss 


6. Re-IPL your new CMS system: 


ip! altcms @ 

DMSINS327I The installation saved segment could not be loaded 
VM/XA ALTCMS mm/dd/yy 

ca 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


7. Define ALTDOS, ALTBAM, ALTAMS, and ALTVSAM: 


set sysname cmsdos altdosin & Use emsdos in this command, not altdos. 
Ready; T=n.nn/n.nn hh:mm:ss 


testnss altdos B 
HCPNSD440I Saved segment ALTDOS was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS A nnnn mm/dd hh:mm:ss ALTCMS — NSS MAINT 
*NSS nnnn NSS nann mm/{dd hh:mm:ss ALTCMSXA NSS MAINT 
*NSS nnnn NSS ninn mn/dd hh:mm:ss GCS NSS MAINT 


*NSS nnnn NSS nonn mm/dd hh:mm:ss ALTINST DCSS MAINT 
*NSS nnan NSS nonn mm/dd hh:mm:ss ALTDSBAM DCSS MAINT 
*NSS nonn NSS S— nnnn mm/dd hh:mm:ss ALTDOS  DCSS MAINT 
Ready; T=n.an/n.nn hh:mm:ss 


“nn > YP YP 


testnss altbam @ 
HCPNSD440I Saved segment ALTBAM was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS A_onnnn mm/dd hh:mm:ss ALTCMS NSS MAINT 


*NSS nonn NSS S— nann mm/dd hh:mm:ss AMTBAM — DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
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testnss altams @ 
HCPNSD440I Saved segment ALTAMS was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS A annn mm/dd hh:mm:ss ALTCMS — NSS MAINT 


*NSS nann NSS) S— nnnn mm/dd hh:mm:ss ALTAMS — DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


testnss altvsam Hf 
HCPNSD440I Saved segment ALTVSAM was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonnn NSS) A nnnn mm/dd hh:mm:ss ALTCMS NSS MAINT 


*NSS noann NSS) S— nnnn mm/dd hh:mm:ss ALTVSAM DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


. Invoke the DOSGEN EXEC with a load address and the name ALTDOS. The load address set up by 
TESTNSS is B00000 for the name ALTDOS. 


access 193 e The load address and name are those 

dosgen b00000 altdos M@ recommended for the ALTDOS segment. Error 
messages for the DOSGEN EXEC are listed on 
page 459. 


HCPNSS440I Saved segment ALTDOS was successfully 
saved in fileid fileno 
PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 
DMSGEN715I DOSGEN COMPLETE 
Ready; T=n.an/n.nn hh:mm:ss 


. To save the load map, rename it and copy it to the CMS BASE] minidisk (193): 


copy load map a altdos segmap e (replace @ 
Ready; T=n.nn/n.nn hh:mm:ss 


Error Messages from DOSGEN 
If DOSGEN detects an error in the address that you specified: 
DMSGENO95E INVALID ADDRESS 
If DOSGEN cannot find a read/write accessed A-disk: 
DMSGENQO6E NO READ/WRITE A-DISK ACCESSED 


If DOSGEN finds unresolved external references while loading the text files: 
DMSGEN111E DOSGEN FAILED DUE TO LOAD ERRORS 

If DOSGEN detects an error while assigning the storage key or saving the segment: 
DMSGEN412S DOSGEN FAILED DUE TO SETKEY ERRORS 


DMSGEN141S DOSGEN FAILED DUE TO SAVESYS ERRORS 
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LQ. Replace the name CMSBAM (not ALTBAM) in the CMS SYSNAME table with any name that is not 
previously used as a segment name: 


set sysname cmsbam sysname The SET SYSNAME command enters an 

Ready; T=n.nn/n.nn hh:mm:ss alternate name for CMSBAM in the SYSNAME 
table. Choose a name that was not used 
previously as a segment name. This command 
does not actually change the saved segment’s 
name, but prevents CP from finding and [PLing 
the segment at the wrong time. 


11. Place your CMS virtual machine in a CMS/DOS environment, then invoke ALTSAMGN to load the 
ALTBAM segment. You must give the EXEC an address at which to load the ALTBAM segment; this 
address also must match the address in the skeleton ALTBAM segment that you defined beforehand. 


set dos on @ This command places your virtual 

machine in a CMS/DOS environment. 
DMSSET400QI SYSTEM sysname DOES NOT EXIST sysname is the name you chose in substep 
DMSSET1101I 100K DOS partition defined 10. 


at hexadecimal location 020000. 
Ready; T=n.nn/n.nn hh:mm:ss 
altsamgn Hf 
DMSSGN363R ENTER LOCATION WHERE ALTBAM 
WILL BE LOADED AND SAVED: 


b1ee0e & 

DMSSGN3641 FETCHING ALTBAM... 

DMSFET710I PHASE DMSVBM ENTRY POINT AT LOCATION B100CO. 
DMSSGN366R ENTER NAME OF SYSTEM TO BE SAVED: 

altbam @ 


HCPNSS4401I Saved segment ALTBAM was successfully The messages indicate that the segment 
saved in fileid fileno has been loaded and saved. 

DMSSGN365I SYSTEM ALTBAM SAVED 

Ready; T=n.nn/n.nn hh:mm:ss 


12. Access the disk that you defined for VSAM when you were installing the system (see Step 28 in 
Chapter 2, Step 28 in Chapter 3, or Step 30 in Chapter 4) as your A-disk. 


access vdevno a @ This puts the minidisk (vdevno) in read/write 
Ready; T=n.nn/n.nn hh:mm:ss mode. 
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13. Invoke ALTVSAMG EXEC: 


altvsamg i 

SELECT ONE OF THE FOLLOWING FUNCTIONS BY ENTERING THE NUMBER: 
1. INSTALL AMS (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
2. INSTALL VSAM (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
3. INSTALL VSAM AND AMS (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
4. BUILD AMS (BUILD DOSLIB, CREATE SEGMENT) 
5. BUILD VSAM (BUILD DOSLIB, CREATE SEGMENT) 
6. BUILD VSAM AND AMS (BUILD DOSLIB, CREATE SEGMENT) 
7. RESTART AMS (CREATE SEGMENT) 

8. RESTART VSAM (CREATE SEGMENT) 
Q. RESTART VSAM AND AMS (CREATE SEGMENT) 

10. QUIT (EXIT ALTVSAMG EXECUTION) 


ENTER RESPONSE... 


6 & Choosing option 6 tells the EXEC to create both 
ALTVSAM and ALTAMS segments as new 
segments, without reading the text files from the 
VSAM product tape. 


If you want to install a new release of VSAM, 
instead of servicing the current release, you must 
erase all files associated with VSAM before you 
issue ALTVSAMG; then, when you issue 
ALTVSAMG, you must choose option 3. 


DMSVGN365R ONE OR MORE OF THE TEXT FILES LISTED IN THE CMSVSAM EXEC 
ARE MISSING. THE VSAM PP PID TAPE SHOULD BE ON TAPE DRIVE 181 
TO RESTORE THE FILES. ENTER: 
'GO' IF TAPE DRIVE IS READY TO LOAD FILES, 
'QUIT' TO STOP GENERATION PROCESS. 
go @ 


Messages 


While ALTVSAMG is processing, you may receive error and information messages. These messages 
are self-explanatory. Messages labeled 21011 are information messages from the linkage editor and 
may be ignored. 


Respond to the EXEC messages as they appear: 


DMSVGN362I LINK-EDITING ALTVSAM ... 
DMSVGN363I ALTVSAM DOSLIB CREATED ON DISK 'A'. 
DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER ‘QUIT'. 
go Hi 
DMSVGN363R ENTER LOCATION WHERE ALTVSAM SHARED WILL BE 
LOADED AND SAVED: 


ba00e0 


DMSVGN363R ENTER LOCATION WHERE ALTVSAM NONSHARED WILL BE 
LOADED AND SAVED: 
a30000 
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DMSVGN364I FETCHING ALTVSAM ... 

DMSFET710I PHASE DMSVVS ENTRY POINT AT LOCATION noannnn 

DSMVGN371R ALTVSAM IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
‘CP’ MODE, APPLY THE ZAPS AND THEN REPLY 'GO' 

go @ 

DMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


altvsam This name is the default name with which the 
segment was defined. 


DMSVGN365I SYSTEM ALTVSAM SAVED. 


DMSVGN368R ERASE ALTVSAM DOSLIB ? ... ENTER ‘YES' OR 'NO': 
no @ 


DMSVGN3621 LINK-EDITING ALTAMS ... 
DMSVGN363I ALTAMS DOSLIB CREATED ON DISK 'A’. 
DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER ‘QUIT’. 
go 
DMSVGN363R ENTER LOCATION WHERE ALTAMS SHARED WILL BE 
LOADED AND SAVED: 


b400e0 @ This is the recommended location. 
DMSVGN363R ENTER LOCATION WHERE ALTAMS NONSHARED WILL BE 
LOADED AND SAVED: 

a00000 & 

DMSVGN364I FETCHING ALTAMS ... 

DMSFET710I PHASE DMSVAS ENTRY POINT AT LOCATION nnnnnn 

DMSFET710I PHASE DMSVAN ENTRY POINT AT LOCATION nannnn 

DMSFET710I PHASE DMSVAX ENTRY POINT AT LOCATION nnnnann 

DMSVGN371R ALTAMS IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
'CP' MODE, APPLY THE ZAPS AND THEN REPLY 'GOQ' 

go & 

DMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


altams @ | This name is the default name used for defining 
the segment. 


DMSVGN365I SYSTEM ALTAMS SAVED. 
DMSVGN368R ERASE ALTAMS DOSLIB ? ... ENTER 'YES' OR 'NO': 


no Hf 
Ready; T=n.nn/n.nn hh:mm:ss 


14. Set DOS off: 


set dos off @ 
Ready; T=n.nn/n.nn hh:mm:ss 


Note: If you loaded files from the VSAM product tape in substep 13 on page 461, do not erase them. 
You will need them in Step 18. 
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Step 12. Install Test CMSINST and HELP Saved Segments 


Warning: Do not skip this step even if you have not changed CMSINST or HELP. 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cp @ 
Ready; T=n.nn/n.nn hh:mm:ss 


2. Make sure that you have the right NAMESAVE segments in your user directory: 


e You must have the NAMESAVE ALTHELP statement in your user directory in order to save the 
HELP file directory information in a test saved segment. 


e Ifthe ALTHELP segment is defined as a member of a segment space, you must have a NAMESAVE 
statement (for example, NAMESAVE ALTINSHP) in the directory entry for the user who invokes 
SAVEFD. SAVEFD specifies the name of the segment space. 


If you have to change the directory, be sure to issue DIRECTXA to bring the changed directory online. 
3. Log on as MAINT (unless you are continuing from the previous step). 
4. Check your virtual storage. If it is less than 16MB, issue the following: 

define storage l6ém & 


STORAGE CLEARED - SYSTEM RESET 
STORAGE = 0016M 


5. IPL your new CMS system: 


ip] altcms @ 
DMSWSP327I The installation saved segment could not be loaded 


VM/XA ALTCMS mm/dd/yy This is a sample version header. If you defined 
a your own version heading, your own heading will 
SYNONYM SYN appear. 


CP TERM MODE VM 


Ready; T=n.nn/n.nn hh:mm:ss Press ENTER to complete the CMS initialization. 


6. Release the INSTHELP segment so that you can define a test segment in the same space: 


segment release insthelp @ 


Chapter 14. Rebuilding CMS after Applying Service 463 
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. Define a segment for ALTINST: 


testnss altinst Hf 
HCPNSD440I Saved segment ALTINST was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) S—onnnn mm:dd hh:mm ALTINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


8. Define the ALTHELP segment: 


testnss althelp @ 
HCPNSD440I Saved segment ALTHELP was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS S~— nnann mm:dd hh:mm ALTINST DCSS MAINT 
*NSS nonn NSS S— nannn mm:dd hh:mm ALTHELP OCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


9. Save both segments: 


saveseg altinst @ Each member saved segment defined by 
SAMPNSS must be saved separately. 


HCPNSS440I Saved segment ALTINST was successfully 
saved in fileid fileno 

Ready; T=n.nn/n.nn hh:mm:ss 

saveseg althelp @ 

HCPNSS440I Saved segment ALTHELP was successfully 
saved in fileid fileno 

Ready; T=n.nn/n.nn hh:mm:ss 


10. Redefine each segment to create the skeleton segments: 


testnss altinst 
HCPNSD440I Saved segment ALTINST was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS S— onnann mn:dd hh:mm ALTINST DOCSS MAINT 
Ready; T=n.an/n.nn hh:mm:ss 


testnss althelp @ 
HCPNSD440I Saved segment ALTHELP was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nnonn NSS) §S— nnnn mm:dd hh:mm ALTINST DCSS MAINT 


*NSS nonn NSS S— nnnn mm:dd hh:mm ALTHELP DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
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11. Using the load list you copied in Step 9, issue the DCSSGEN command as follows: 


access 193 e ALTINST EXECLIST E its the file ID of the file 
dcssgen altinst execlist e altinst Mf that contains the list of EXECs and editor macros 
to be loaded into the test segment. 


ALTINST is the name of the test segment. 


HCPNSS440I Saved segment ALTINST was successfully 
saved in fileid fileno 
Ready; T=n.nn/n.nn hh:mm:ss 


Note: When you built your ALTCMS nucleus, if you indicated in the DMSNGP file (USEINST = YES) 
or in answer to the DMSINQ296R prompt that you wanted to use the installation segment (the 
default is YES), then this segment is used each time a user IPLs ALTCMS. If you previously 
indicated that you did not want to use the installation segment but now want to use it, you must 
modify the DMSNGP file to indicate that the segment should be used, then assemble the modified 
DMSNGP and rebuild ALTCMS. 


Messages from DCSSGEN Command 


While DCSSGEN is processing, you may receive error or warning messages that indicate specific 
conditions. If errors were encountered, after processing is complete you receive the following prompt: 


DMSEXG298R An error has been detected while building the 
DCSS. Do you still want the DCSS saved? 
Enter 1 (YES) or © (NO). 


Enter 1 to disregard the error(s) and save the segment, or enter 0 to not save the segment. If you do 
not save the segment, you receive the message: 


DMSEXG288I segname not saved 


If DCSSGEN encounters an error while saving the segment, you receive the message: 


DMSEXG288E dcssname not saved 


If your virtual machine is not large enough to contain the segment (you need 16M), you receive the 
message: 


DMSEXG284E The DCSS is not completely inside the virtual machine 


To correct this situation, increase the size of your virtual machine, re-I[PL ALTCMS, and reissue the 
DCSSGEN command. 


12. Define your virtual storage less than the address at which the ALTHELP segment is to be loaded. For 
example, if the ALTHELP segment is defined at X'C50000', define your storage as 12MB. 


define storage 12m @ 
STORAGE CLEARED - SYSTEM RESET 
STORAGE = 12M 
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13. Re-IPL your test CMS system: 


ip] altcms @ 


VM/XA ALTCMS mm/dd/yy This is a sample version header. 
ei 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


14. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cms @ 


15. Issue the following commands to initialize and save the segment: 


(For more information about using the SAVEFD command to save minidisk file directory information in 
a saved segment, refer to VM/XA SP CMS Command Reference. For more information on saved 
segments, refer to VM/XA SP Guide to Saved Segments.) 


savefd init vaddr label althelp @ vaddr is 49D for mixed-case American English, 
Ready; T=n.nn/n.nn hh:mm:ss 49C for uppercase American English. 


label is the CMS label assigned to the disk. (In 
this sample procedure, it is MNT49D or 
MNT49C.) 


segment purge altinst @ 
Ready; T=n.nn/n.nn hh:mm:ss 


savefd save voddr label althelp @ 

DMSACP723I Z(19D) R/O 

HCPNSS44QI Saved segment ALTHELP was successfully 
saved in fileid fileno 

Ready; T=n.nn/n.nn hh:mm:ss 


16. Verify that the ALTINST and ALTHELP segments were defined correctly: 


query nss all @ 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS fileno NSS A nnnn mm/dd hh:mm:ss ALTINSHP NSS MAINT 


*NSS fileno NSS A = nnnn mm/dd hh:mm:ss ALTINST NSS MAINT 
*NSS fileno NSS A’ nonn mm/dd hh:mm:ss ALTHELP NSS MAINT 


17. Redefine your storage before you continue: 


define storage l6m @ 

STORAGE = 16M 

Storage cleared - system reset 
ipl altcms Hf 

VM/XA ALTCMS mm/dd/yy 

es) 

Ready; T=n.nn/n.nn hh:mm:ss 
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Step 13. Test the System 


Now that you have applied service to all necessary files, you must test the system to make sure that the 


problem has been fixed. 


1. Test the system. 


2. To allow selected users to test the system, have them issue the following commands: 


#cp link maint 490 490 rr @ 
password 

set sysname cmsdos altdos @ 
set sysname cmsbam altbam @ 
set sysname cmsvsam altvsam Hf 
set sysname cmsams altams @ 
ipl altcms @ 


If the service performs to your satisfaction, perform Steps 14—19 to rebuild your system on the 190 disk. If 


the service fails, then you must find the problem, correct it, and re-test the system. 
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Step 14. Purge the Test Named Saved Systems and Saved 
Segments 
1. Issue QUERY NSS ALL to determine the spool IDs of the test named saved systems and saved segments 


segments you created in Step 10, Step 11, and Step 12 (ALTCMS, ALTCMSXA, ALTDSBAM, 
ALTDOSIN, ALTDOS, ALTBAM, ALTVSAM, ALTAMS, ALTINSHP, ALTINST, and ALTHELP): 


query nss all @ 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) A onnnn mm/dd hh:mm:ss ALTCMS = NSS MAINT 
*NSS nonn NSS) A—nnnn mm/dd hh:mm:ss ALTCMSXA NSS MAINT 
*NSS nonn NSS A nonn mm/dd hh:mm:ss ALTDSBAM DCSS MAINT 
*NSS nonn NSS A nnnn mm/dd hh:mm:ss ALTDOSIN DCSS MAINT 
*NSS nonn NSS A nnnn mm/dd hh:mm:ss ALTDOS — DCSS MAINT 
*NSS nonn NSS A—nnnn mm/dd hh:mm:ss ALTBAM — DCSS MAINT 
*NSS nonn NSS) A nnnn mm/dd hh:mm:ss ALTVSAM OCSS MAINT 
*NSS nonn NSS A_nnann mm/dd hh:mm:ss ALTAMS — DCSS MAINT 
*NSS nonn NSS) A_nnnn mm/dd hh:mm:ss ALTINSHP DCSS MAINT 
*NSS nnon NSS A nnnn mm/dd hh:mm:ss ALTINST ODCSS MAINT 
*NSS nonn NSS) A_onnnn mm/dd hh:mm:ss ALTHELP DCSS MAINT 


The spool ID is the number in the second column, 
under the heading FILE. 


Ready; T=n.nn/n.nn hh:mm:ss 


2. Purge the named saved systems and saved segments: 


purge nss spoolid!l ... spoolidn & You can list as many spool IDs as necessary on a 
single PURGE NSS command. 


The PURGE NSS command will take effect as soon as all users stop using the named saved systems and 
saved segments. 
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Step 15. Put the New CMS System into Production 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cms @ 


. Rename DMSNGP TEXT to save it. Then edit the DMSNGP ASSEMBLE file and make the following 


changes: 
a. Change SYSDISK = 490 to SYSDISK = 190. 
b. Change IPLADDR = 490 to IPLADDR = 190. 
c. Change HELP=49D to HELP=19D (or HELP =49C to HELP=19C). 


d. Change SYSNAME=newname to SYSNAME=CMS, where newname is the name you choose for 
your test system. The sample procedure in this chapter uses ALTCMS. 


e. Change INSTSEG = newname to SYSNAME=CMSINST, where newname is the name you choose 
for your test installation segment. The sample procedure in this chapter uses ALTINST. 


f. Change the VERSION = and INSTID= parameters to identify your new CMS system. 


These changes will cause the new CMS nucleus (with service) to be rebuilt on the 190 minidisk. 


. Reassemble the DMSNGP ASSEMBLE file: 


vmfhasm dmsngp 56643089 cms @ 


. Copy DMSNGP TEXT to the CMS alternate LOCAL] disk (395): 


copy dmsngp text a = = fm (replace @ fm is the CMS alternate LOCAL! disk (395). 


. Use the DASD DUMP Restore program to copy the 490 disk to the 190 disk: 


Note: Access the 190 disk as R/W, using an unassigned filemode. 


ddr 
VM/XA SYSTEM PRODUCT DASD DUMP RESTORE PROGRAM 
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS. 


ENTER: 

sysprint cons @ This command tells DDR to send program 

ENTER: messages to your console. 

input 490 devtype MNT490 Ml 490 is your test CMS system disk. devtype is the 

ENTER: device type of the DASD volume where 490 is 
located. 

output 190 devtype MNT190 @ 190 is your new CMS system disk. devtype is the 

ENTER: device type of the DASD volume where 190 is 
located. 
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copy 000 endcyl @ The value for endcyl depends on the device type of 
your 490 disk: 


Device Type endcyl 


3350 73 
3375 112 
3380 71 
3390 67 
DMKDDR711R Volid Read is MNT490. Do you You have not yet changed the label of the 190 
wish to continue? minidisk. (You do so in substep 6 on page 470.) 
yes Hf 
ENTER NEXT EXTENT OR NULL LINE: 
a 
END OF COPY 
ENTER: 
a 
END OF JOB 
6. Re-label the 190 minidisk: 
access 190 c Hf 
DMSACP723I C(190) R/O 
DMSACC725I 190 ALSO = S DISK 
format 190 c (label &@ You must use the label option. If you do not, you 
ENTER LABEL: erase all the files on the 190 minidisk. 


mnt190 

Ready; T=n.nn/n.nn hh:mm:ss 
release c Hf 

Ready; T=n.nn/n.nn hh:mm:ss 


7. Repeat substeps 5 on page 469 and 6 to copy the alternate HELP disks (49D, 49C, 49B...) to their 
corresponding current disks (19D, etc.) and to re-label the current disks as MNT19n. Check the 
minidisk definitions in your user directory to find the appropriate value for endcy’l. 


8. Erase DMSNGP TEXT on your A-disk: 


erase dmsngp text a @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 16. Rebuild the Nucleus 


1. Spool punch output to your own virtual reader: 


spool punch * 
Ready; T=n.nn/n.nn hh:mm:ss 


. Generate the new CMS nucleus: 


vmfbld 56643089 cms (punch This invokes the VMFBLD EXEC to build a new 

LOAD LIST: $$$TLL$$ EXEC Al (MNT191) nucleus for CMS. The VMFBLD EXEC performs 

: a number of system generation functions for you. 
For more information on this EXEC, see 
“VMFBLD EXEC” on page 652. 


RDR FILE fileno SENT FROM MAINT PUN AS fileno The system loader punches the CMS nucleus. 


RECS nnnn COPY 001 N NOHOLD NOKEEP This message tells you that the punch file is 
complete. 
Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be that a 


PTF which 1s now being applied has another PTF, 
outside CMS, as a prerequisite. Check the 
SVMFBLD $ERRLOG file for message 
DMSBNC1854W. 


. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build 


. Ensure that the proper files are in your virtual reader: 


query rdr * all @ The ALL operand requests a display of all 
information about the reader files. 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 
MAINT =onnnn * PUN nannnnnn 001 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 
Ready; T=n.nn/n.nn hh:mm:ss 


. Order your reader so that the CMS nucleus will be processed first: 


order rdr fileno @ fileno is the file number of the CMS nucleus. 
Ready; T=n.nn/n.an hh:mm:ss 


. Ensure that the virtual reader is readied for class * reader files: 


query virtual 00c HF 

RDR O00C CL cl NOCONT NOHOLD EOF READY 
Q0OC 2540 CLOSED NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 
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10. 


. If the virtual reader is not class *, issue: 


spool rdr class * keep @ The KEEP option places the spool file in USER 
Ready; T=n.nn/n.nn hh:mm:ss HOLD status after it has been read. To remove 
this file from your reader, issue purge rdr fileno, 
where fileno is the file number of the reader file. 


. IPL your virtual reader: 


ip] 00c @ 
DMSINS327I The installation saved segment could not be loaded 


Informational message: The CMSINST 
installation segment has not been loaded and 


saved yet. 
VM/XA CMS 5.6 mm/dd/yy hh:mm 
a 
SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss The ready message indicates that the nucleus has 


been loaded to your 190 minidisk successfully. 


. Receive the CMS load map into your reader: 


spool prt * nohold @ 
close prt * # 


Query the reader to identify the CMS load map: 


query rdr * all @ 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 
MAINT fileno M PUN nannnnnn 001 NONE mm/dd hh:mm:ss SYSPROG 


The CMS load map is the file with a blank 
filename and filetype. It has approximately 8,100 
records. The exact size varies according to the 
system default language, local modifications, and 
VMSUPFP level. Note the fi/eno of this file. You 
will use it in your next command. 


vnfsetup 56643089 cms Mf The CMS load map is loaded on the CMS 
receive fileno fn ft fm @ LOCAL] (395) minidisk. 
fn ft fm created 
DMSRDC738I Record length is 132 bytes 
File fn ft D received from MAINT at 
nodeid as fn ft fm 
Ready; T=n.nn/n.nn hh:mm:ss 
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You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as 1-9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 


Note: From this point on, to IPL your new production system, issue ip? 196 MH. 
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Step 17. Rebuild Named Saved Systems 


1. Use the SAMPNSS EXEC to define segments and save your new CMS and CMSXA: 


sampnss cms cmsxa Wl The SAMPNSS EXEC issues the 
DEFSYS command. 

HCPNSD4401 The Named Saved System (NSS) CMS was Note: The names are positional on the 
successfully defined in fileid SAMPNSS command (the 
fileno. System/370 name followed by the 

HCPNSD440I The Named Saved System (NSS) CMSXA was 370-XA name). 

a” eee gre The SAMPNSS EXEC first issues the 


DEFSYS command to define a skeleton 
system data file for CMS and for 
CMSXA. These messages tell you the 
DEFSYS commands were successful. 


OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nnnn NSS) S— nnnn mm/dd hh:mm:ss CMS NSS MAINT 
*NSS nnnn NSS S— nnnn mmfdd hh:mm:ss CMSXA NSS MAINT 


Ready; T=n.nn/n.nn hh:mm:ss 
The SAMPNSS EXEC issues a QUERY 
NSS command. These messages show 
what system data files are defined. 


2. Issue the QUERY NSS ALL MAP command to make sure CMS 1s defined properly. Verify that the 
information under BEGPAG, ENDPAG, TYPE, and CL in the response to QUERY NSS ALL MAP ts 
the same as shown. 


query nss all map @ 
FILE FILENAME FILETYPE MINSIZE BEGPAG ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


nnnn CMS NSS 000256K O0000 OOOOA EW S$ Q0000 OMITTED NO 
00020 00022 EW 
QOEOO OOFFF SR 

nnonn CMSXA NSS Q00256K O0000 OOO0A EW S$ 0000 OMITTED NO 
00020 Q0022 #£EW 
QOEOO OOFFF SR 


3. Set your machine mode to 370, load CMS (IPL 190), and save the CMS system: 


set machine 370 @ 


ip] 190 clear parm savesys cms Load 190 with the option to save the system under 
the name CMS. 


HCPNSS440I1 The named saved system CMS was 
successfully saved in fileid fileno. 
VM/XA CMS 5.6 mm/dd/yy hh:mm 


| Press ENTER to initialize CMS: 
Ready; T=n.nn/n.nn hh:mm:ss 
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4. Set your machine mode to XA, load CMS (IPL 190), and save the CMSXA system: 


set machine xa @ 


ip] 190 clear parm savesys cmsxa Ml Load 190 with the option to save the system under 
the name CMSXA. 


HCPNSS440I The named saved system CMSXA was 
successfully saved in fileid fileno. 
VM/XA CMS 5.6 mm/dd/yy hh:mm 


a Press ENTER to initialize CMSXA. 
Ready; T=n.nn/n.nn hh:mm:ss 


5. Set your machine mode to 370 (or XA), redefine your virtual storage to 2 megabytes, and load the CMS 
(or CMSXA) named saved system. The example below shows loading CMS in System/370 mode: 


set machine 370 @ 
define storage 2m Mf 


STORAGE = 2M Defining storage causes a system reset. 

STORAGE CLEARED - SYSTEM RESET 

ip] cms @ 

VM/XA CMS 5.6 mm/dd/yy hh:mm 

a After receiving the version identification, press 

Ready; T=n.nn/n.nn hh:mm:ss ENTER to complete CMS or CMSXA 
initialization. 


6. Check the CMS status by issuing QUERY NSS ALL and QUERY NSS ALL MAP. Verify that the 
information under FILENAME and FILETYPE in the response to QUERY NSS ALL is the same as 
shown. Also, verify that the information under BEGPAG, ENDPAG, TYPE, and CL in the response to 
QUERY NSS ALL MAP is the same as shown. The system data file should now have class A (rather 
than S) and have one user (MAINT). 


query nss all @ 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) A nnnn mm/dd hh:mm:ss CMS NSS MAINT 
*NSS noann NSS A_—nnnn mn/dd hh:mm:ss CMSXA NSS MAINT 


Ready; T=n.nn/n.nn hh:mm:ss 
query nss all map @ 
FILE FILENAME FILETYPE MINSIZE BEGPAG ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


nonn CMS NSS 000256K 00000 OO00A EW A 00001 OMITTED NO 
00020 Q0022 EW 
QOEOG OOFFF SR 

nnnn CMSXA NSS 000256K 00000 OQ00A EW A QQ000 OMITTED NO 
90020 00022 £EW 
QOEOO OOFFF SR 


Ready; T=n.nn/n.nn hh:mm:ss 
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Step 18. Reinstall the CMSDOS, CMSBAM, CMSVSAM, and 
CMSAMS Saved Segments 


Warning: Do not skip this step even if you have not changed CMSDOS, CMSBAM, CMSVSAM, or 
CMSAMS. 


The CMSDOS and CMSBAM< segments must be installed before you install the CMSVSAM and 
CMSAMS segments. 


1. Define your storage as 16 megabytes and IPL your new CMS system: 


define storage l6m @ 
STORAGE = 0016M 
STORAGE CLEARED - SYSTEM RESET 


ip] cms @ 
VM/XA CMS 5.6 mm/dd/yy hh:mm 
** DO NOT press ENTER! ** 


access (noprof This command suppresses execution of MAINT’s 
PROFILE EXEC. 


2. Establish the appropriate minidisk access order: 


access 5E5 b @ 
access 193 e 


3. Issue: 
set emsg on @ You want to see any and all error messages during 
Ready; T=n.nn/n.nn hh:mm:ss execution of the installation EXEC. 


4. Define a segment into which the DOSGEN EXEC can load CMSDOS: 


defseg dosinst 900-90f sr @ 


HCPNSD440I Saved segment DOSINST was This command defines a 1MB segment for 
successfully defined in fileid DOSINST starting at 900000. You may place this 
fileno segment anywhere below the segment spaces 

Ready; T=n.nn/n.nn hh:mm:ss defined for CMSDOS, CMSBAM, CMSVSAM,, 

and CMSAMS. 


5. Invoke the DOSGEN EXEC with a load address and the name DOSINST. The load address used for 
DOSINST in this example is 900000. 


dosgen 900060 dosinst @ 
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HCPNSS440I Saved segment DOSINST was successfully 
saved in fileid fileno 
PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 
DMSWGN715I DOSGEN COMPLETE 
Ready; T=n.nn/n.nn hh:mm:ss 


. Re-IPL your new CMS system: 


ip] cms @ 

VM/XA CMS 5.6 mm/dd/yy hh:mm 
a 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


. Establish the appropriate minidisk access order: 


access 193 e @ 


The load address and name are those 


recommended for the DOSINST segment. 
Error messages for the DOSGEN EXEC 
are listed on page 459. 


. Define CMSDOS, CMSBAM, CMSAMS, and CMSVSAM: 


set sysname cmsdos dosinst @ 

Ready; T=n.nn/n.nn hh:mm:ss 

sampnss cmsdos 

HCPNSD440I Saved segment CMSDOS was successfully 
defined in fileid fileno 


OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonnn NSS) A nnnn mm/dd hh:mm:ss CMS 
*NSS nnnn NSS nnnn mm/dd hh:mm:ss CMSXA 
*NSS nann NSS noon mm/dd hh:mm:ss GCS 
*NSS nnnn NSS nonn mm/dd hh:mm:ss DOSINST 
*NSS nann NSS nonn mm/dd hh:mm:ss DOSBAM 
*NSS nonn NSS S— nnnn mm/dd hh:mm:ss CMSDOS 
Ready; T=n.nn/n.nn hh:mm:ss 


“n> LY YP 


sampnss cmsbam &@ 

HCPNSD440I Saved segment CMSBAM was successfully 
defined in fileid fileno 

OWNERID FILE TYPE CL RECS DATE TIME FILENAME 

*NSS ninn NSS) A onnann mm/dd hh:mm:ss CMS 


*NSS nnnn NSS S_ nnnn mn/dd hh:mm:ss CMSBAM 
Ready; T=n.nn/n.nn hh:mm:ss 


sampnss cmsams Mf 

HCPNSD440I Saved segment CMSAMS was successfully 
defined in fileid fileno 

OWNERID FILE TYPE CL RECS DATE TIME FILENAME 

*NSS nonn NSS A_nnnn mm/dd hh:mm:ss CMS 


*NSS nonn NSS) S_ nnnn mm/dd hh:mm:ss CMSAMS 
Ready; T=n.nn/n.nn hh:mm:ss 


NSS 
NSS 
NSS 
DCSS 
DCSS 
DCSS 


FILETYPE 
NSS 


DCSS 


FILETYPE 
NSS 


DCSS 


MAINT 
MAINT 
MAINT 
MAINT 
MAINT 
MAINT 


ORIGINID 
MAINT 


MAINT 


ORIGINID 
MAINT 


MAINT 
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Sampnss cmsvsam 
HCPNSD440I Saved segment CMSVSAM was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nann NSS) A onnnn mm/dd hh:mm:ss CMS NSS MAINT 


*NSS nonn NSS S_— nnnn mm/dd hh:mm:ss CMSVSAM DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


9. Invoke the DOSGEN EXEC with a load address and the name CMSDOS. The load address set up by 
SAMPNSS is B00000 for the name CMSDOS. 


dosgen b00000 cmsdos @ The load address and name are those 
recommended for the CMSDOS segment. Error 
messages for the DOSGEN EXEC are listed on 
page 459. 


HCPNSS440I Saved segment CMSDOS was successfully 
saved in fileid fileno 
PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nonn COPY 001 A NOHOLD NOKEEP 
DMSGEN715I DOSGEN COMPLETE 
Ready; T=n.nn/n.nn hh:mm:ss 


10. To save the load map, rename it and copy it to the 193 minidisk (E): 


copy load map a cmsdos segmap e (replace Ml 
Ready; T=n.nn/n.nn hh:mm:ss 


11. Replace the name CMSBAM in the CMS SYSNAME table with any name that is not previously used as 
a segment name: 


set sysname cmsbam sysname The SET SYSNAME command enters an 

Ready; T=n.nn/n.nn hh:mm:ss alternate name for CMSBAM in the SYSNAME 
table. Choose a name that was not previously 
used as a Segment name. This command does not 
actually change the saved segment’s name, but 
prevents CP from finding and JPLing the segment 
at the wrong time. 


12. Place your CMS virtual machine in a CMS/DOS environment, then invoke SAMGEN to load the 
CMSBAM segment. You must give the EXEC an address at which to load the CMSBAM segment; this 
address also must match the address in the skeleton CMSBAM segment that you defined beforehand. 


set dos on This command places your virtual] machine in a 
CMS/DOS environment. 
DMSSET400I SYSTEM sysname DOES NOT EXIST sysname is the name you chose in substep 11. 


DMSSET1101I 100K DOS partition defined 
at hexadecimal location 020000. 
Ready; T=n.nn/n.nn hh:mm:ss 
samgen Hf 
DMSSGN363R ENTER LOCATION WHERE CMSBAM 
WILL BE LOADED AND SAVED: 
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13. 


14. 


b16000 

DMSSGN3641 FETCHING CMSBAM... 

DMSFET7101 PHASE DMSVBM ENTRY POINT AT LOCATION B100CO. 
DMSSGN366R ENTER NAME OF SYSTEM TO BE SAVED: 

cmsbam i 


HCPNSS4401 Saved segment CMSBAM was successfully The messages indicate that the segment has been 
saved in fileid fileno loaded and saved. 

DMSSGN365I SYSTEM CMSBAM SAVED 

Ready; T=n.nn/n.nn hh:mm:ss 


Access the VSAM product disk (the same disk you accessed in Step 11, substep 12 on page 460) as your 
A-minidisk. 


access vdevno a & 
Ready; T=n.nn/n.nn hh:mm:ss 


Invoke VSAMGEN EXEC: 


vsamgen 

SELECT ONE OF THE FOLLOWING FUNCTIONS BY ENTERING THE NUMBER: 
1. INSTALL AMS (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
2. INSTALL VSAM (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
3. INSTALL VSAM AND AMS (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
4. BUILD AMS (BUILD DOSLIB, CREATE SEGMENT) 
5. BUILD VSAM (BUILD DOSLIB, CREATE SEGMENT) 

6. BUILD VSAM AND AMS (BUILD DOSLIB, CREATE SEGMENT) 
7. RESTART AMS (CREATE SEGMENT) 

8. RESTART VSAM (CREATE SEGMENT) 

9. RESTART VSAM AND AMS (CREATE SEGMENT) 

10. QUIT (EXIT VSAMGEN EXECUTION) 


ENTER RESPONSE... 


6 Choosing option 6 tells the EXEC to create both 
CMSVSAM and CMSAMS segments as new 
segments, without reading the text files from the 
VSAM product tape. If you read in new files 
from the VSAM product tape in substep 13 on 
page 461 of Step 11, you will use those files now. 


Messages 


While VSAMGEN is processing, you may receive error and information messages. These messages 
are self-explanatory. Messages labeled 21011 are information messages from the linkage editor and 
may be ignored. 
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Respond to the EXEC messages as they appear: 


DMSVGN362I LINK-EDITING CMSVSAM ... 
DMSVGN363I CMSVSAM DOSLIB CREATED ON DISK ‘A’. 
DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER 'QUIT'. 
go & 
DMSVGN363R ENTER LOCATION WHERE CMSVSAM SHARED WILL BE 
LOADED AND SAVED: 


ba0000 


DMSVGN363R ENTER LOCATION WHERE CMSVSAM NONSHARED WILL BE 
LOADED AND SAVED: 
a30000 @ 


DMSVGN364I FETCHING CMSVSAM ... 

DMSFET710I PHASE DMSVVS ENTRY POINT AT LOCATION nnnnnn 

DSMVGN371R CMSVSAM IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
'CP' MODE, APPLY THE ZAPS AND THEN REPLY 'GO' 

go @ 

DMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


cmsvsam This name is the default name with which the 
segment was defined. 


DMSVGN365I SYSTEM CMSVSAM SAVED. 


DMSVGN368R ERASE CMSVSAM DOSLIB ? ... ENTER 'YES' OR 'NO': 
no @ 


DMSVGN362I LINK-EDITING CMSAMS ... 
DMSVGN363I CMSAMS DOSLIB CREATED ON DISK 'A'. 
DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER ‘QUIT’. 
go @ 
DMSVGN363R ENTER LOCATION WHERE CMSAMS SHARED WILL BE 
LOADED AND SAVED: 


b40000 This is the recommended location. 
DMSVGN363R ENTER LOCATION WHERE CMSAMS NONSHARED WILL BE 
LOADED AND SAVED: 

200000 

DMSVGN364I FETCHING CMSAMS ... 

DMSFET710I PHASE DMSVAS ENTRY POINT AT LOCATION nnnnnn 

DMSFET/710I PHASE DMSVAN ENTRY POINT AT LOCATION nnnnnn 

DMSFET710I PHASE DMSVAX ENTRY POINT AT LOCATION nnnnnn 

DMSVGN371R CMSAMS IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
‘CP’ MODE, APPLY THE ZAPS AND THEN REPLY 'GO' 

go @ 

DMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


cmsams @ This name is the default name used for defining 
the segment. 


DMSVGN365I SYSTEM CMSAMS SAVED. 
DMSVGN368R ERASE CMSAMS DOSLIB ? ... ENTER 'YES' OR 'NO': 


no @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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15. You may now purge the DOSINST named saved segment: 


query nss all @ 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS A_nnnn mm/dd hh:mm:ss CMS NSS MAINT 


*NSS nonn NSS) Annan mm/dd hh:mm:ss DOSINST ODCSS MAINT 


Ready; T=n.nn/n.nn hh:mm:ss 


purge nss fileno @ fileno is the file identifier for DOSINST. 
No files purged 

0001 file pending purged 

Ready; T=n.nn/n.nn hh:mm:ss 


16. Set DOS off: 


set dos off @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 19. Reinstall the CMSINST and HELP Saved Segments 


Warning: Do not skip this step even if you have not changed CMSINST or HELP. 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cp 


2. Make sure that you have the right NAMESAVE segments in your user directory: 


e You must have the NAMESAVE HELP statement in your user directory in order to save the HELP 
file directory information in a saved segment. 


e If the HELP segment is defined as a member of a segment space, you must have a NAMESAVE 
statement (for example, NAMESAVE INSTHELP) in the directory entry for the user who invokes 
SAVEFD. SAVEFD specifies the name of the segment space. 


3. Log on as MAINT (unless you are continuing from the previous step). 
4. Check your virtual storage. If it is less than 16MB, issue the following: 
define storage l6m @ 


STORAGE CLEARED - SYSTEM RESET 
STORAGE = 0016M 


5. IPL your new CMS system: 
ip! cms @ 
VM/XA CMS 5.6 mm/dd/yy Ah:mm 


a Press ENTER to complete the CMS initialization. 
SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


6. Purge your old CMSINST segment: 


segment purge cmsinst @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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. Define a segment for CMSINST: 


Note: If you have increased the number of entries in the CMS load list, be sure that the DEFSEG entry 
for CMSINST in the SAMPNSS EXEC has enough pages defined to accomodate the increased 
sIze. 


sampnss cmsinst 
HCPNSD440I Saved segment CMSINST was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS A nnonn mm:dd hh:mm CMS NSS MAINT 


*NSS nonn NSS S— nnann mm:dd hh:mm CMSINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


The EXEC issues a QUERY command that 
displays information about the segments defined 
for named saved systems. 


. Define the HELP segment: 


sampnss help Hf 
HCPNSD440I Saved segment HELP was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS) A-onnnn mm:dd hh:mm CMS NSS MAINT 


*NSS nonn NSS S— nnnn mm:dd hh:mm CMSINST DCSS MAINT 
*NSS nonn NSS S— nnnn mm:dd hh:mm HELP DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


. Save both segments: 


saveseg cmsinst Each member saved segment defined by 
SAMPNSS must be saved separately. 


HCPNSS440I Saved segment CMSINST was successfully 
saved in fileid fileno 

Ready; T=n.nn/n.nn hh:mm:ss 

saveseg help @ | 

HCPNSS440I Saved segment HELP was successfully 
saved in fileid fileno 

Ready; T=n.nn/n.nn hh:mm:ss 
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10. Redefine each segment to create the skeleton segments: 


Sampnss cmsinst Hf 
HCPNSD440I Saved segment CMSINST was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nnnn NSS) A_onnnn mm:dd hh:mm CMS NSS MAINT 


*NSS nonn NSS) S— nnann mm:dd hh:mm CMSINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
sampnss help @ 
HCPNSD440I Saved segment HELP was successfully 

defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nnnn NSS) A onnnn mm:dd hh:mm CMS NSS MAINT 


*NSS nnonn NSS S-—onann mm:dd hh:mm CMSINST DCSS MAINT 
*NSS nonn NSS S_— nnnn mm:dd hh:zmm HELP DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


11. You may have created a load list for the DCSSGEN command during the installation process. The one 
created in the sample installation process was called INSTLIST FILE. It should be on your A-disk 
(191). Ifit is not there, you probably used the IBM-supplied load list. This load list is called CMSINST 
EXECLIST. It should be on your K-disk (193). Using one of these load lists, issue the DCSSGEN 
command as follows: 


access 193 e Jn ft fm is the fileid of the file that contains the list 
dcssgen fn ft fm cmsinst of EXECs and Editor macros to be loaded into 
the segment. 


CMSINST is the name of the segment. 
CMSINST is the default name used for defining 
the segment and for specifying the segment name 
in DMSNGBP or in response to the installation 
questions. If you do not specify a segment name, 
the default name is CMSINST. 


HCPNSS440I Saved segment CMSINST was successfully 
saved in fileid fileno 
Ready; T=n.nn/n.nn hh:mm:ss 


Note: When you built your CMS nucleus, if you indicated in the DMSNGP file (USEINST = YES) or in 
answer to the DMSINQ296R prompt that you wanted to use the installation segment (the default 
is YES), then this segment is used each time a user IPLs CMS. If you indicated earlier that you 
did not want to use the installation segment but now want to use it, you must modify the 
DMSNGFP file to indicate that the segment should be used, then assemble the modified DMSNGP 
and rebuild CMS. 


12. Define your virtual storage as less than the address at which the HELP segment is to be loaded. For 
example, if the HELP segment is defined at X'C50000', define your storage as 12MB. 


define storage 12m Hf 
STORAGE CLEARED - SYSTEM RESET 
STORAGE = 12M 
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13. 


14. 


15. 


16. 


17. 


Re-IPL your new CMS system: 


ip] cms @ 
VM/XA CMS 5.6 mm/dd/yy hh:mm 
| 


SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 


Establish the appropriate minidisk access order: 


vmfsetup 56643089 cms Ml 


Issue the following commands to initialize and save the segment: 


(For more information about using the SAVEFD command to save minidisk file directory information in 
a saved segment, refer to VM/XA SP CMS Command Reference. For more information about saved 
segments, refer to VM/XA SP Guide to Saved Segments.) 


savefd init vaddr label help @ vaddr is 19D for mixed-case American English, 
Ready; T=n.nn/n.nn hh:mm:ss 19C for uppercase American English. 


label is the CMS label assigned to the disk. (The 
labels in the sample directory are MNT19D and 
MNT19C.) 


savefd save vaddr label help @ 

DMSACP723I Z(19D) R/O 

HCPNSS440I Saved segment HELP was successfully 
saved in fileid fileno 

Ready; T=n.nn/n.nn hh:mm:ss 


Verify that the CMSINST and CMSHELP segments are defined correctly: 


query nss all @ 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS fileno NSS A nnnn mm/dd hh:mm:ss INSTHELP NSS MAINT 
*NSS fileno NSS A_nnnn mm/dd hh:mm:ss CMSINST NSS MAINT 
*NSS = fileno NSS A_nnnn mm/dd hh:mm:ss HELP NSS MAINT 


Redefine your storage before you continue: 


define storage l6m Mf 


STORAGE = 16M 
Storage cleared - system reset 
ipl cms 


VM/XA CMS 5.6 mm/dd/yy hh:mm 
= 
SYNONYM SYN 


CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 20. Back Up the Named Saved Systems 


Use the procedure in Step 30 of Chapter 2, “Installing VM/XA System Product Release 2.1 with the Starter 
System (First Level)” to back up the new CMS and CMSXA named saved systems. 


What to Do Next 


e You have finished the service procedure for CMS. 


e If you are also servicing CP, see Chapter 15, “Rebuilding CP after Applying Service” on page 487. 
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Chapter 15. Rebuilding CP after Applying Service 


This chapter describes a step-by-step procedure for rebuilding CP after applying program update service, 


corrective service, or local service. 


Should You Be Doing This Now? 


e If you are also servicing CMS, you must rebuild CMS before you rebuild CP. If you have not yet rebuilt 
CMS, see Chapter 14, “Rebuilding CMS after Applying Service” on page 431. 


e Otherwise, continue with this chapter. 
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Step 1. Build a New CP Macro Library 


Note: This step describes a method of updating the CP macro libraries that isolates all of the serviced 
macros and control blocks into a separate MACLIB using the VMFMAC EXEC. The new 
MACLIB is added to the MACS record in the HCPXA CNTRL file. 


An alternate method of updating the CP macro libraries is to update each affected MACLIB with 
the changed macro or control block by using the MACLIB command. (See VM/XA SP CMS 
Command Reference for details on the MACLIB command.) 


If you choose the alternate method of building new CP macro libraries, do so now and continue 
with “Step 2. Update the CP Message Repository” on page 491. 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cp Hf 


2. Determine the macros and control blocks you have service for: 


e Search the DELTA string for all macros and control blocks you have service for: 


listfile * A*HP fml (execs args fname @ fm] is the alternate DELTA (594) disk. 

listfile * A*HP fm2 (append args fname Mf fm2 is the intermediate alternate DELTA (591) 
disk. 

listfile * A*HP fm3 (append args fname @ fm3 is the current DELTA (294) disk. 


e Ifa CMS EXEC does not exist on your A-disk after these commands, no serviced macros or control 
blocks were found on the DELTA string. Continue with substep 3. 


e Save the filenames in the CPUPDATE EXEC and erase the CMS EXEC: 


copyfile cms exec a cpupdate = = (replace 
erase cms exec a @ 


e Determine which of the updated files are macros (filetype MACRO), and which are control blocks 
(filetype COPY). Store the results in the CPNEW EXEC: 


cpupdate listfile % macro * (append args ftype @ 


cpupdate listfile % copy * (append args ftype MIgnore the messages that appear on your screen 
while these two commands are processing. 


¢ Ifa CMS EXEC does not exist on your A-disk after these commands, no serviced macros or control 
blocks were found on the DELTA string. Continue with substep 3. 
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e Save the filenames in the CPNEW EXEC: 


copyfile cms exec a cpnew = = (replace @ 


e Edit the CPNEW EXEC to remove any duplicate entries: 


xedit cpnew exec @ 
sort * 115 @ 


file @ 


3. Determine the macros and control blocks for which you have local service. Follow your installation’s 
naming conventions for locally serviced files. Locally serviced files should reside on the LOCAL] disk 
string. 


e If no macros and control blocks have local service, continue with substep 4. 


e Otherwise, add your locally serviced macros and control blocks to CPNEW EXEC. When you are 
done, the CPNEW EXEC should list all macros and control blocks for which you have received IBM 
service (if any), plus any macros and control blocks for which you have local service. 


If you do not have a CPNEW EXEC on your A-disk, copy the HCPGPI EXEC to use as a template: 


copyfile hcpgpi exec fm cpnew = a (recfm f Irecl 80 @ 


If you created the CPNEW EXEC by copying the HCPGPI EXEC, use the contents of the HCPGPI 
EXEC only for a guide to the format of the entries. After you have added the macro and control 
block names you need, in the proper format, delete the macro names that originated from the 
HCPGPI EXEC: 


xedit cpnew exec a @ 


file E 


4. If you have no updated macros or control files at this point, continue with “Step 2. Update the CP 
Message Repository” on page 491. 


5. Generate the new macro library on your A-disk (191) by using the VMFMAC EXEC: 


vmfmac cpnew hcpxa @ 
DMSUPD178I1 Updating macroname MACRO fm 
DMSUPD178I Applying macroname update fm 
macroname MACRO ADDED 


Ready; T=n.nn/n.nn hh:mm:ss 


6. The contents of CPNEW COPY were appended to CPNEW MACLIB. You can now erase CPNEW 
COPY (a file created by VMFMAC) on your A-disk (191): 


erase cpnew copy a Hf 
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ie 


8. 


10. 


Add the new macro library name to the TEXT MACS card in the HCPXA CNTRL file. 


List the new macro library first so that you use the updated macros. If you have already done this 
during previous service to CP, you do not have to do this now. 


xedit hcpxa cntrl fm @ fm is the CP BASE}! disk (194). 
locate/TEXT MACS 


TEXT MACS maclib ... 
change/MACS/MACS CPNEW/ 


TEXT MACS CPNEW maclib ... 
file 


Copy the changed files from your A-disk to the CP database: fm is the alternate DELTA disk (594) if 
you have no local service to the macro or copy files. fm is the alternate LOCAL disk (295) if you have 
any local service to the macro or copy files. 


copyfile cpnew exec a = = fm (olddate replace @ 
copyfile cpnew maclib a = = fm (olddate replace @ 


. To make the MACLIB you just created available to general users, copy it from the CP database to your 


CMS alternate BUILD1 disk (490): 


copyfile cpnew maclib origin-fm = = target-fm2 (olddate replace @ 


origin-fm is the disk you copied the changed files 
to in the previous substep. target-fm is the CMS 
alternate BUILD1 disk (490). 


Erase the working copies on your A-disk: 


erase cpnew exec a Hf 
erase cpupdate exec a Mi 
erase cpnew maclib a 


If you have any image library updates, refer to VM/XA SP Planning and Administration. 
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Step 2. Update the CP Message Repository 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cp 


2. Determine your system default national language: 


query lang @ 


langid See Table 5 on page 311 to identify the language 
corresponding to langid. Note the country code 
for that language. 


3. Invoke the VMFNLS EXEC to update the CP message repository: 


vmfnis hcpmesy repos 56643089 cp y is the country code for your system national 
Ready; T=n.nn/n.nn hh:mm:ss language. 


4. If you have updates to the message repositories for any other national languages installed on your 
system, repeat substep 3 for each language. 


5. Copy the changed files from your A-disk to the CP database: fm is the alternate DELTA disk (594) if 
you have no local service to the macro or copy files. fm is the alternate LOCAL disk (295) if you have 
any local service to the macro or copy files. 


copyfile hcpmesy {text|txtnnnnn} a = = fm (olddate replace @ 
copyfile hcpmesy listing a = = fm (olddate replace @ 


6. Erase the working copies on your A-disk: 


erase hcpmesy {text|txtnnnnn' a Hf 
erase hcpmesy listing a @ 
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Step 3. Assemble the Changed ASSEMBLE Files 


Do this step if you have local modifications to ASSEMBLE files. 


|. Establish the appropriate minidisk access order: 
vmfsetup 56643089 cp Hf 


2. Determine which ASSEMBLE files you must reassemble: 


e Although you will not receive any updates affecting HCPRIO ASSEMBLE or HCPSYS 
ASSEMBLE, you must reassemble these files because macros used within these files may have been 
serviced. 


¢ Use the list of parts for which you have both local modifications and IBM service that you made in 
Chapter 13, Applying Service to CP. 


3. Copy and unpack the ASSEMBLE files you need to reassemble from the CP current BASE2 disk (394), 
to your A-disk: 


copy hcpxxx assemble fm = = a (unpack olddate mM Substitute the last 3 characters of the filename of 
Ready; T=n.nn/n.nn hh:mn:ss the ASSEMBLE file for xxx. 


4. Use the VMFHASM EXEC to update and assemble all the files for which you have both IBM service 
and local modifications: 


vmfhasm hcpxxx 56643089 cp Mf Substitute the last 3 characters of the filename of 
the ASSEMBLE file for xxx. 


The text file created will be placed on the A-disk. 
5. Copy all the text files from the A-disk to the alternate LOCAL] (295) disk: 
copy hcpxxx {text|xxxnnnnn} a = = fm (replace olddate @ 


6. If you reassembled any files that are not in the CP load list. copy the text decks to the alternate LOCALI 
disk again, giving the copy the filetype TEXT: 


copy hcpxxx {text|xxxnnnnn| a = text fm (replace olddate M@ 


7. Erase all the ASSEMBLE files and text files on your A-disk: 


erase hcpxxx assemble a 
erase hcpxxx {text|xxxnnnnn} a 


8. Repeat substeps 3—7 for each file that must be reassembled. 
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Step 4. Build the CP Nucleus 


Warning: 


e If you have received service for HCPLDL ASSEMBLE or the HCPMDLAT macro, you must issue 
UTILITY CPLOAD to rebuild the CPLOADEXEC before you build the nucleus. See “Step 7. Build 
Utilities” on page 501 for more details. 


If you have received service to HCPLDR ASSEMBLE, you must issue UTILITY GEN HCPLDR to 
rebuild the HCPLDR LOADER. 


Before you run VMFBLD, you must also rebuild the other CP build lists if they are serviced. The 
complete list of CP build lists is found in the :BLD. section of the CP portion of the PPF. 


Use the procedures in “Step 8. Regenerate System Product Interpreter Programs” on page 504 to 
rebuild the build lists, and return here. 


1. Make a backup copy of your system, using the DASD dump restore program. 
2. Define storage as 16 megabytes and IPL your system disk: 


define storage 16m @ 


STORAGE = 16M 

STORAGE CLEARED - SYSTEM RESET Defining storage causes a system reset. 

ip] sysaddr sysaddr is your CMS system disk (either 190 or 
VM/XA CMS 5.6 mm/dd/yy hh:mm 490). 

ia After receiving the version identification, press 
Ready; T=n.nn/n.nn hh:mm:ss ENTER. 


3. Spool punch output to your own virtual reader: 


spool punch * 
Ready; T=n.nn/n.nn hh:mm:ss 


4. Invoke the VMFBLD EXEC to build a new CP nucleus: 
vmfbld 56643689 cp (punch 
LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 
RDR FILE fileno SENT FROM MAINT PUN AS fileno RECS nnnn COPY 001 N NOHOLD NOKEEP 


The system loader punches the CP nucleus. This 
message tells you that the punch file is complete. 


Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be that a 
PTF now being applied has another PTF, outside 
CP, as a prerequisite. Check the SVMFBLD 
SERRLOG file for message DMSBNC1854W. 
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5. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build 


. Ensure that the proper files are in your’s virtual reader: 


query rdr * all @ The ALL operand requests a display of all 
information about the reader files. 

ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 

MAINT = nnnn * PUN nnnnnnnn 001 NONE mm/dd hh:mm:ss $$$TLL$$ IPL SYSPROG 


Ready; T=n.nn/n.nn hh:mm:ss 


. Order your reader so that the CMS nucleus will be processed first: 


order rdr fileno @ fileno is the file number of the CMS nucleus. 
Ready; T=n.nn/n.nn hh:mm:ss 


. Ensure that the virtual reader is readied for class * reader files: 


query virtual 00c 

RDR OOQ0C CL cl NOCONT NOHOLD' EOF READY 
Q00C 2540 CLOSED NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 


. If the virtual reader is not class *, issue: 


spool rdr class * keep The KEEP option places the spool file in USER 
Ready; T=n.nn/n.nan hh:mm:ss HOLD status after it has been read. To remove 
this file from your reader, issue purge rdr /ileno, 
where fileno is the file number of the reader file. 


Perform the next two substeps only if you are generating a CP nucleus with a preferred virtual machine. 


10. Precautions must be taken if the new CP nucleus is to contain a virtual=real area (including 


Il. 


virtual = fixed storage) but you are not ready to load (IPL) the new nucleus. If the virtual=real guest is 
running a job, then let it finish its present work and do not allow more work to begin. The reason for 
this precaution is that virtual =real recovery may fail in the event of a system restart. 


Find out how much virtual storage MAINT has and define more if necessary. If you are generating a 
CP nucleus with a preferred virtual machine, MAINT’s virtual storage must be at least 4 megabytes 
greater than the sum of the VRSIZE, VRFREE, and RIO370 operands in the SYSSTORE macro 
instruction in HCPSYS ASSEMBLE. For more information on the SYSSTORE macro instruction, refer 
to VM/XA SP Planning and Administration. 


vmfsetup 56643089 cp @ 


Ready; T=n.nn/n.nn hh:mm:ss 
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12. 


xedit hcpsys assemble Mi Check the size of the VRSIZE and VRFREE 
; operands. 

locate /VRSIZE @ 

qquit 

Ready; T=n.nn/n.nn hh:mm:ss 


query virtual storage @ 
STORAGE = nnnnM 


define storage nnnnm @ 


STORAGE = nnnnM 
STORAGE CLEARED - SYSTEM RESET 


If you are using the starter system defaults, issue the following commands to make sure that the new 
nucleus does not overlay the production nucleus on the system residence volume while your system Is in 
production: 


set machine 370 @ 
Ready; T=n.nn/n.nn hh:mm:ss 


cpformat 423 xasres 000-endcyl CPFORMAT the 423 minidisk with label 
CPFORMAT: XASRES. 

FORMAT WILL ERASE CYLINDERS 0000-0009 ON DISK 423 
DO YOU WANT TO CONTINUE ? (YES | NO) 

yes 

FORMAT STARTED 

FORMAT COMPLETE 

CURRENT ALLOCATION 


The value of endcyl depends on two things: the 
DASD type and whether you are are using the 423 
minidisk defined in the sample directory, or a 
full-pack minidisk that you have defined on a 
second XASRES volume. 


TYPE CYLINDERS Device endcyl for endcyl for 
ee re ae Type Sample 423 —s- Full-Pack 423 
PERM 0000-endcyl 3350 0012 0554 
ENTER ALLOCATION DATA 3375 0015 0958 
TYPE CYLINDERS 3380 0009 0884 
eer rr eer 3380-E4 0009 1769 
3380-K 0009 2654 
3390-1 0009 1112 
3390-2 0009 2225 
end Allocate the whole area as PERM. 


CURRENT ALLOCATION 

TYPE CYLINDERS 

PERM 0000-endcyl 

ALLOCATE COMPLETE 

VOLUME LABEL IS NOW 'XASRES' 
HCPFAM3841 CPFORMAT COMPLETE 
SYSTEM RESET 


define 123 nnn @ nnn is any address you are not using. 
DASD nnn DEFINED 
Ready; T=n.nn/n.nn hh:mm:ss 


define 423 123 Define the 423 minidisk as virtual 123. This is the 
DASD 0123 DEFINED default address for the system residence volume. 
Ready; T=n.nn/n.nn hh:mm:ss 
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define nnn 423 @ Define the a backup pack for the system residence 
DASD 0423 DEFINED volume. This is your old 123 minidisk. 
Ready; T=n.nn/n.nn hh:mm:ss 


13. You must perform this substep if you redefined MAINT’s virtual storage as greater than 16 megabytes: 


set machine xa Storage addresses greater than 16 megabytes 
require 370/XA architecture. 


14. Load (IPL) your virtual reader: 


ip] 00c @ 

MSG FROM MAINT  : The 9010 disabled wait state indicates that the CP 
HCPGEN9O10W NUCLEUS LOADED ON XASRES nucleus is successfully loaded on the system 
CP ENTERED; DISABLED WAIT residence device. If you receive a different 
PSW OQOA0000 00009010 disabled wait state code, see VM/XA SP System 


Messages and Codes Reference. 


If you entered a disabled wait state with a code 
8028, you did not observe the warning notes 
dealing with virtual storage size in the substeps 
above. 


15. You have now loaded the nucleus to the 423 disk. (This is also the test 123 minidisk, labeled MNT123.) 
If you are using the starter system defaults, this is a holding area for the new nucleus. 


16. Issue the following commands: 


set machine 370 @ 
define storage l6m @ 


17. Save the CP load map. 


a. The load map has been spooled to MAINT’s virtual printer. To save the load map on MAINT’s 
LOCALI (295) minidisk: 


spool prt nohold MH 
close prt 


ipl] sysoddr sysaddr is your CMS system disk (either 190 or 
490). 


b. Query the printer to see if the load map is still there: 


query prt all 

OWNERID FILE CLASS RECORDS CPY HOLD DATE TIME DIST 

MAINT fileno A PRT nnnnnnnn 001 NONE mm/dd hh:mm:ss SYSPROG 

Ready; T=n.nn/n.nn hh:mm:ss The CP load map is the file with a blank 
filename and filetype. It has approximately 
30,000 records. The exact size varies according 
to the system default language, local 
modifications, and VMSUP level. 
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| CP Load Map in Virtual Printer Only | 


c. Transfer the printer file to your reader: 


transfer prt fileno * rdr @ 
RDR FILE fileno TRANSFERRED FROM * FILE fileno 


0001 FILE TRANSFERRED 
Ready; T=n.nn/n.nn hh:mm:ss 


Es ee ee End of CP Load Map in Virtual Printer Only ee 


d. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cp @ 
Ready; T=n.nn/n.nn hh:mm:ss 


query rdr * all @ 


OWNERID FILE CLASS RECORDS CPY HOLD USERFORM OPERFORM KEEP MSG 
MAINT fileno A PRT nannnnnn 001 NONE STANDARD STANDARD OFF OFF 


Note the fileno in this message. You will use it 
in your next command. 


receive fileno fn ft fm Save the load map on the LOCALI (295) 
Ready; T=n.nn/n.nn hh:mm:ss minidisk. 


You can assign any filename and filetype to the load map. You may want to adopt a naming 
convention for the load maps, to save the map from each build. For example, you can name each 
map in the format compnamemap ymdd to distinguish each build. 


Notes: 


1) ymdd represents the date in four digits: last digit of the year, month (represented as 1—9, A, B, 
C), and day. 


2) Nucleus maps are very large. You may have to save old maps on another disk. 


e. To print a copy of the load map for the CP nucleus: 


print fn ft d @ Substitute the filename and filetype you entered 
Ready; T=n.nn/n.nn hh:mm:ss on the RECEIVE command above. The load 
map is printed on your system printer. 


18. Redefine your nucleus areas at their original addresses: 


define 423 nnn Hf 
DASD nnn DEFINED 


Ready; T=n.nn/n.nn hh:mm:ss 


define 123 423 
DASD 0423 DEFINED 


Ready; T=n.nn/n.nn hh:mm:ss 


define nnn 123 @ 
DASD 0123 DEFINED 


Ready; T=n.nn/n.nn hh:mm:ss 
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Step 5. Test the CP Nucleus 


Warning: You can do this step only if your test XASRES volume is a full-pack minidisk. If you are using a 
10-cylinder minidisk, the only testing you can do is verifying that you can load the nucleus on the test 423 
minidisk. You did this when you IPLed your test XASRES in Step 4. Go to Step 6. 


Now that you have applied service to all necessary parts, you should test the system to make sure that the 
problem has been fixed. 


1. Test your new nucleus: 
a. Use the IPL DDRXA utility with the DUMP NUC option to dump the nucleus on 123 to tape. 
b. Define your test XASRES volume as virtual 4A0. (If you use the sample HCPRIO in this book, you 


cannot use address 123 because that address is defined as a console.) 


detach 0123 Hf 
define 423 04A0 @ 


c. Set your virtual machine in XA mode and define your console at a valid virtual address in the 
HCPRIO file: 


set machine xa 
Ready; T=n.nn/n.nn hh:mm:ss 


query cons @ 
CONS vdevno ... 


define vdevno 0020 
term conmode 3270 


d. IPL your test XASRES volume at second level. Do not perform a hardware IPL. 


ip! 4A0 clear # 
wl Press ENTER to create an interrupt. 


If you can IPL your test XASRES volume successfully, continue with Step 5. 
Note: You may need to define some temporary spool and paging space. 


2. Test your system at second level. If it performs to your satisfaction, do “Step 6. Put the New CP 
System into Production” on page 500. If the system fails, do not do Step 6. Find out what went wrong 
and start over with a new fix. 
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3. Shut down your second-level system. A class A user (usually the primary system operator) must issue the 
SHUTDOWN command. 


shutdown @ 


SYSTEM SHUTDOWN STARTED 

SYSTEM WARM START DATA SAVED 

SYSTEM SHUTDOWN COMPLETE 

HCPGIR450W CP ENTERED; DISABLED WAIT 
PSW O00A0000 00000961 


4. Link to your production-level XASRES pack in read/write mode: 


#cp tink * 123 123 mr @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 6. Put the New CP System into Production 
1. Load (IPL) MAINT’s virtual reader: 


ip] 00c clear @ 


hh:mm:ss * MSG FROM MAINT — : The 9010 disabled wait state indicates that the CP 
HCPGEN9O10W NUCLEUS LOADED ON XASRES nucleus is successfully loaded on the system 
HCPGIR450W CP ENTERED; DISABLED WAIT residence device. 


PSW Q00A0000 00009010 If you enter a disabled wait state with a code 691, 


you did not observe the warning notes above. 


If you receive a different disabled wait state code, 
see VM/XA SP System Messages and Codes 
Reference. 


2. Shut down your system. A class A user (usually the primary system operator) must issue the 
SHUTDOWN command. 


shutdown 


SYSTEM SHUTDOWN STARTED 

SYSTEM WARM START DATA SAVED 

SYSTEM SHUTDOWN COMPLETE 

HCPGIR450W CP ENTERED; DISABLED WAIT 
PSW QO0A0000 00000961 


3. IPL the new CP nucleus: 


IPL sysadr @ 
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Step 7. Build Utilities 


| Note: This step shows you how to build utilities. It does not show you how to do assemblies. UTILITY 
| EXEC builds utilities. It does not assemble anything. 


1. IPL CMS: 
ip] sysadr @ sysadr is the CMS system disk (either 190 or 490). 
VM/XA CMS 5.6 mm/dd/yy hh:mm 
ei 


2. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cp Hf 


| 3. Determine whether you have to build any utilities. 


| ¢ Make and sort a list of the files you are servicing: 


| listfile hcp* text fm (exec fm is the alternate DELTA disk (594). 
| listfile hcpldr txt* fm (append @ 

| listfile hcpmdlat * fm (append @ 

| listfile hcpsadmp * fm (append @ 


| listfile hcp* text fm (append @ fm is the alternate LOCALI disk (295). 

| rename cms exec a hcptext = = & The exec option saves the list in a file called 
| xedit hcptext exec @ CMS EXEC. Any previously existing CMS 
| sort * 115 EXEC on your A-disk is erased. 

| file @ 


e Check this list against Table 13. You must rebuild any utility you find listed there. 


4, Find each utility you have to rebuild in the first column of the table. Enter the command in the second 
column: 


utility gen filename @ 
Ready; T=n.nn/n.nn hh:mm:ss 


Table 13 (Page 1 of 2). UTILITY GEN Commands 


Assemble 
Filename Command to Enter File Created by This Command 


Note: If you receive service for a CP TEXT deck not listed in this table, it will be regenerated in some 
other way. You do not need to regenerate it now. (See Table 16 on page 573 in Appendix A, 
“VM/XA System Product Regeneration Requirements” for the procedure used. Text decks not 
listed in this table, or in Table 16 on page 573, will become part of the nucleus when the system is 
built if they are listed in the CP load list.) 


HCPBSL utility gen 3card loader Mf 3CARD LOADER 


HCPCCF utility gen cpfmtxa Mf CPFMTXA MODULE 
HCPFAx 


HCPFON 
HCPCCU utility gen hepecu HCPCCU MODULE 
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Table 13 (Page 2 of 2). UTILITY GEN Commands 


Assemble 

Filename Command to Enter File Created by This Command 

HCPDDC utility gen ddr IPL DDRXA 

HCPDDR DDR MODULE 

HCPDDT 

HCPDNC 

HCPDNT 

HCPDIR utility gen directxa DIRECTXA MODULE 
directxa user direct B 

HCPEDx utility gen dumpload & DUMPLOAD MODULE | 

HCPIFC utility gen cperepxa CPEREPXA MODULE 

HCPIMG utility gen genimage Mf GENIMAGE MODULE 

HCPLDL utility cpload @ CPLOAD EXEC 

HCPMDLAT 

HCPLDR utility gen hepldr @ HCPLDR MODULE 

HCPMOW utility gen monwrite Hf MONWRITE MODULE 

HCPNMT utility gen imagelib H IMAGELIB MODULE 

HCPOVE utility gen override # OVERRIDE MODULE 

HCPRET utility gen retricve @ RETRIEVE MODULE 


HCPSADMP utility gen hcpsadmp Stand-alone dump program 


5. Test the utilities. 
6. Copy any utilities generated on the A-disk to the alternate DELTA disk. Then erase them on the A-disk: 


copyfile fn ft A= = fm Hi jn and ft are entries from Table 13 on page S501. 
erase fn ft A @ fm is the alternate DELTA disk (594). 


7. Copy all serviced MODULES to their appropriate build disks: 
¢ Make a list of the utilities you are servicing. 
Note: This list includes all serviced utilities on the alternate DELTA disk whether or not you 


regenerated them in the previous step. 


filelist * MODULE fm @ fm is the alternate DELTA disk (594). 


e Make a list of all parts for each filename in the filelist by pressing PF9. Press PF9 for each file in 
the original filelist. 


e Copy the new executable version of the module to the appropriate build disks: 


— If an executable version (with filetype MODULE) exists on the BUILD! disk, copy the new 
version there. 


— If an executable version does not reside on one of these disks, refer to the documentation 
supplied with the PTF to determine where it should reside. 
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copyfile / = = fm2 (olddate replace @ Enter this command on the filelist screen next to 
the file you want to copy. You are copying 
these files from the alternate DELTA disk (594) 
to the BUILD! disk (490). 


Use filemode 2 for files copied to the BUILD1 
disk so they can be seen by other users. 


e Press PF2 to refresh the screen to verify that your changes have been made. 
e When you have processed each file in the original filelist screen use PF3 to exit filelist. 


8. Repeat substep 7 for the other utilities. Replace the filetype of MODULE with filetypes of DDRXA, 
LOADER. and EXEC. 
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Step 8. Regenerate System Product Interpreter Programs 


| 


| 1. Establish the appropriate minidisk access order: 


| vmfsetup 56643089 cp Hf 


| 2. Regenerate any System Product Interpreter programs (EXECs, XEDIT macros, and the $DASD$ 
| CONSTS foil) for which you have received IBM service and for which you have local modifications. (If 
| you have none, go to substep 3). 


| e Use the list of parts for which you have both local modifications and IBM service that you made in 
| Chapter 13, Applying Service to CP. 


| e If you reworked or kept your local modifications, you must now regenerate the System Product 
| Interpreter programs (EXECs, XEDIT macros, and the $3DASD$ CONSTS file). Repeat the 
| following three commands for each file that needs to be regenerated. 


| Note: ft is EXEC, XEDIT, or CONSTS. Remember to include the leading dollar sign ($) when it is 
| specified. 


| copyfile fn $ft origin-fm = = destination-fm Wl origin-fm is the BASE2 disk (394). 
| destination-fm is the alternate DELTA disk 
| (594). 


| The file is copied to the alternate DELTA disk 
| because the EXECUPDT command puts the 
| object file on the same disk as the source file. 


| execupdt fn ft fm (ctl hcpxa hist option HF HCPXA is the CP control filename. 


| For any files with a SID code in columns 
| 63 —71, use the SID option. 


| erase fn $ft fm Mf fm is the alternate DELTA disk (594). 


| 3. Copy all serviced EXECs to their appropriate build disks: 
| e Make a list of the EXECs you are servicing. 
| Note: This list includes all the serviced EXECs on your alternate DELTA disk whether or not you 


| regenerated them in the previous step. 


| filelist * EXEC fm & fm is the alternate DELTA disk (594). 


| e Make a list of all parts of each filename in the filelist using PF9. Press PF9 for each file in the 
| original filelist. 


| e Identify the latest version of the EXEC: 
| — If you just regenerated the EXEC in the previous step, you already have the latest level. 


| — If you did not regenerate the EXEC, use the associated AUX files to determine the latest PTF 

| against the given EXEC. This PTF number is the top one in the AUX file. Locate the 

| PTF-numbered version of the EXEC (with filetype EXCnnnnn, where nnnnn is the PTF number). 
| This PTF-numbered version of the EXEC is the version you want to use. 


| — If the EXEC is not maintained with updates, it will not have any associated AUX files and you 
| have to use the internal documentation in the EXEC to determine the PTF-numbered version to 
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use. Do not depend on date and time stamps; examine the actual files. Each file ends with an 
update summary that indicates the file’s service history. The latest version is the one with the 
most service. Files with filetypes of EXCnannn and XEDnnnnn are exact images of the 
corresponding EXEC and XEDIT executables. 


e Copy the PTF-numbered version that you just selected to its executable filetype on the alternate 
DELTA disk. This step does not apply to those EXECs that you regenerated with the EXECUPDT 


command. 

copyfile / = EXEC fm (olddate replace @ Enter this command on the filelist screen next to 
the file you want to copy. /m 1s the alternate 
DELTA disk (594). 


e Press PF2 to refresh the screen to verify that your changes have been made. 
¢ Copy the new executable version of the module to the appropriate build disks: 


— If an executable version (with filetype EXEC) exists on the BUILD! disk, copy the new version 
there. 


— If an executable version exists on the TASK disk, copy the new version there. 
— If an executable version does not reside on one of these disks, refer to the documentation 


provided with the PTF to determine where it should reside. 


copyfile / = = fm2 (olddate replace @ Enter this command on the filelist screen next to 
the file you want to copy. You are copying 
these files from the alternate DELTA disk (594) 
to the BUILD1 disk (490), the TASK disk 
(SES), or both. 


Use filemode 2 for files copied to the BUILD] 
disk so they can be seen by other users. 


e Press PF2 to refresh the screen to verify that your changes have been made. 
e Return to the original filelist screen using PF3. 
e When you have processed each file in the original filelist screen, use PF3 to exit filelist. 
4. Repeat substep 3 for XEDIT macros. Replace EXEC with XEDIT and EXCannnn with XEDnnnnn. 


5. Repeat substep 3 for the $3DASD$ CONSTS file. Replace EXEC with CONSTS and EXCnannnn with 
CONnannn. 
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Step 9. Test and Rebuild CMS 


Perform Steps 10, 13, 15, 16, and 17 of Chapter 14, “Rebuilding CMS after Applying Service” on page 431, 
to make the files on the 490 disk available to users. 


Step 10. Back Up the CP System 


Use the procedure in Step 31 of Chapter 2, “Installing VM/XA System Product Release 2.1 with the Starter 
System (First Level)” to back up your new CP system. 


This is the end of the service procedure for CP. 
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Chapter 16. Service to DV 


This chapter describes: 


¢ Receiving PUT or COR service for DV 
e Applying PUT or COR service to DV 
¢ Rebuilding DV. 


Should You Be Doing This Now? 


e Have you done the preparation steps in Chapter 9, “Preparing For Service” on page 415? If not, do so 
now. 


¢ Otherwise, continue with this chapter. 
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Step 1. Receive Service 


Note: If you are using ServiceLink to receive service electronically, use the procedure in Chapter 19, “Using 


ServiceLink to Receive Service” on page 533. 


1. Attach a tape drive to MAINT: 


attach vdevno * 181 @ 


. Mount and ready the PUT or COR tape. 
. Map the PUT or COR tape and receive the documentation. Mapping the tape means verifying that all 


the necessary files exist. Enter: 


release c VMFREC INFO (MEMOS xxx loads documents 
Ready; T=n.nn/n.nn hh:mm:ss to your C-disk if it is accessed, otherwise to your 
A-disk. 
vmfrec info (memos xxx Hf xxx 1s put if you are mapping a PUT tape, or cor 
DMSREC1852I This is n of n if you are mapping a COR tape. If the tape you 
level level {PUT|COR} tape mounted is not the type of tape you specified, you 


recelve an error message. 


VMFREC INFO (MEMOS maps the tape and 
loads the tape map, PUT DOCUMENT or COR 
DOCUMENT, and the Memo to Users (56643089 
MEMO) to your A-disk. Read these documents 
before going on. Print these documents to save a 
record of them. If you do not save a copy of 
these documents, they will be over-written the next 
time you receive a PUT or COR tape. 


If your system default language is uppercase 
American English, you may get message 
DMSMGM8I4E. This message is caused by a 
problem with the REXX date function. You can 
ignore It. 


Ready; T=n.nn/n.nn hh:mm:ss 


. Review the receive exception log (SVMFREC S$ERRLOG) to be sure that the MEMOs were loaded 


correctly: 


vmfview receive 


. Receive the service files to the target minidisks you specified in the product parameter file. Enter: 


vnfrec 56643089 dv (xxx E xxx is put for a PUT tape, or cor for a COR tape. 
If you need to invoke an override file, substitute 
that file’s name for 56643089. 


DMSREC1852I This is n of n 
level level {PUT|COR} tape 
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DMSREC1869R 56643089 DV begins on {PUT|COR} If you do not have the correct volume mounted, 
level volume vol. Mount mount it now. 


correct volume and press ENTER The VMFREC EXEC loads the service files to the 


. Or EYpe ieee target minidisk. 


DMSREC1852I This is n of n 
level level {PUT|COR} tape 

DMSREC1086I The current Service Diskmap contains 
the map of the mounted tape. 

DMSREC1804I Receiving service for component DV of product 
56643089 


Ready; T=n.nn/n.nn hh:mm:ss 


. Review the receive exception log (SVMFREC $ERRLOG), and correct any problems before continuing: 


vmfview receive @ 
Ready; T=n.nn/n.nn hh:mm:ss 


| | To Receive More Than One COR Tape | 


If you want to receive additional COR tapes at this time: 


1. You must suppress the automatic merging that occurs before a receive. Read “Preventing Automatic 


Merging” in Appendix G, “Controlling Disk String Merges” on page 861 and choose a method of 
preventing automatic merging. 


. For each COR tape you want to receive, repeat substeps 2 — 6. 


. Create an apply list for the VMFAPPLY EXEC to use that contains the PTFs from all the COR tapes 


you just received: 


listfile hcsxa $apc* fm @ fm is the alternate DELTA disk (593). 
HCSXA $APCALL fim 
HCSXA $APCO109 fim 
HCSXA $APCO119 fm 
HCSXA $APCO126 fm 
HCSXA $APC9C22 fm 


xedit hcsxa $applist fn Mf Edit the HCSXA $APPLIST file on the alternate 
get $apcymdd Wf DELTA disk. This file will already contain the 
file i apply list from the last tape that you loaded. Do 


a GET command in XEDIT once for each 
HCSXA $APCymdd file shown by your 
LISTFILE command. 


Note: If the VMFAPPLY EXEC encounters duplicate entries for the same PTF, it issues a message 
telling you that the PTF has already been applied. This is an informational message; you can 
ignore it. 


. Create an exclude list for the VMFAPPLY EXEC to use that contains the excluded PTFs from all the 


COR tapes you just received: 


Note: Do not be concerned if the exclude lists are empty. 
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| listfile hcsxa $exc* fm fm is the alternate DELTA disk (593). 
| HCSXA $EXCALL fm 
| HCSXA $EXC0109 fm 
| HCSXA $EXCOQ119 fm 
| HCSXA $EXC0126 fm 
| HCSXA $EXC9C22 fm 


xedit hcsxa $exclist fm Ml Edit the HCSXA $EXCLIST file on the alternate 
get $excymdd Ml DELTA disk. This file will already contain the 
file i exclude list from the last tape that you loaded. 


HCSXA $EXCymdd file shown by your 


| 

| 

| 

| Do a GET command in XEDIT once for each 
| 

| LISTFILE command. 


| fe es End of To Receive More Than One COR Tape bo Ss 
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Step 2. Apply the Updates 


1. Consult your IBM service representative for the appropriate preventive service planning (PSP) bucket for 
your system’s VMSUP level and PUT level. Check the bucket and add the appropriate entries to the 
exclude list. The exclude list is called HCSXA $EXCLIST. 


Note: If two PTFs are in the same text deck, you cannot exclude the first unless you also exclude the 
second, even if you list the first one on the exclude list. This restriction applies because the first 
PTF is considered to be a prerequisite for the second PTF. 


If you list the first PTF in the exclude list, but not the second, and if the second PTF appears in 
the apply list, both PTFs will be applied. You will receive an error message indicating that a PTF 
you wanted to exclude has been applied. 


2. Establish the appropriate minidisk access order: 


vmfsetup 56643089 dv Mf 


3. Apply the service, that is, create auxiliary control files: 


vmfapply 56643089 dv (xxx xxx is put for PUT service, or cor for COR 
DMSAPP1853I Processing PTF ptfnum service. 


Ready; T=n.nn/n.nn hh:mm:ss 


4. Review the apply exception log (SVMFAPP $ERRLOG), and correct any problems before continuing. 
The information in the apply exception log is used later when you rebuild the dump viewing facility. 


vmfview apply If you receive message number DMSAPP1885W, 
VMFAPPLY has applied service to a module for 
which you have a local modification. 


You can use the PF keys with the VMF VIEW 
EXEC to get useful lists of information. If you 
position the cursor on a line that contains message 
1885W and press PF2, VMFVIEW displays all the 
occurrences of message 1885W. Similarly, if you 
press PF6é, VMF VIEW displays all the messages 
with the BD: prefix. You can use the XEDIT 
PUT command to save these messages in a file for 
future reference. 


Decide what you want to do with the local modification: 


¢ To remove a local modification, see Chapter 20, “Receiving and Applying Local Service” on 
page 543, and Chapter 22, “Removing Service from VM/XA SP” on page 559. 


¢ To rework a local modification, see Chapter 20, “Receiving and Applying Local Service” on 
page 543. 


e To keep a local modification, do nothing now. You will regenerate the part to pick up the local 
modification when you rebuild DV. 


Save the names of all the parts for which you have both local modifications and IBM service. You will 
need the part names later when you rebuild DV. 


Whether you remove, rework, or keep local modifications, you do not have to reissue VMFAPPLY. 
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Step 3. Build the Dump Viewing Facility 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 dv @ 


2. Build the dump viewing facility: 


utility dvfgend all @ 


3. Copy all MODULE files created by UTILITY DVFGEND ALL to the BUILD1 disk (490), then erase 
them on your A-disk: 


copy fn module a = = fm2 (OLDDATE REPLACE 


Ready; T=n.nn/n.nn hh:mm:ss 
erase fn module a Mf 


4. Copy all MAP files created by UTILITY DVFGEND ALL to the APPLY disk (692), then erase them on 
your A-disk: 


copy fn map a = = fm & 


Ready; T=n.nn/n.nn hh:mm:ss 
erase fn map a 


5. Copy DVF interface files to the CMS system disk: 


vmfbld 56643089 dv 


6. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build @ 
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_ Step 4. Regenerate System Product Interpreter Programs 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 dv @ 


2. Regenerate any EXECs and XEDIT macros for which you have received IBM service and for which you 
have local modifications. (If you have none, go to substep 3). 


e Use the list of parts for which you have both local modifications and IBM service that you made in 
“Step 2. Apply the Updates.” 


¢ If you reworked or kept your local modifications, you must now regenerate the EXECs and XEDIT 
macros. Repeat the following three commands for each file that needs to be regenerated. 


Note: ff is either EXEC or XEDIT. Remember to include the leading dollar sign ($) when it is 
specified. 


copyfile fn $ft origin-fm = = destination-fm @ origin-fm is the BASE2 disk (393). 
destination-fm is the alternate DELTA disk 
(593). 


The file 1s copied to the alternate DELTA disk 
because the EXECUPDT command puts the 
object file on the same disk as the source file. 


execupdt fn ft fm (ctl hesxa hist option @ HCSXA is the dump viewing facility control 
filename. 


For any files with a SID code in columns 
63 —71, use the SID option. 


erase fn $ft fn fm is the alternate DELTA disk (593). 


3. Copy all serviced EXECs to their appropriate build disks: 
e Create a list of the EXECs you are servicing. 
Note: This list includes all the serviced EXECs on your alternate DELTA disk whether or not you 


regenerated them in the previous step. 


filelist * EXEC fm @& fm is the alternate DELTA disk (593). 


e Create a list of all parts of each filename in the filelist using PF9. Press PF9 for each file in the 
original filelist. 


e Identify the latest version of the EXEC: 
— If you just regenerated the EXEC in the previous step, you already have the latest level. 


— If you did not regenerate the EXEC, use the associated AUX files to determine the latest PTF 
against the given EXEC. This PTF number is the top one in the AUX file. Locate the 
PTF-numbered version of the EXEC (with filetype EXCnnnnn, where nnnnn is the PTF number). 
This PTF-numbered version of the EXEC is the version you want to use. 


— If the EXEC is not maintained with updates, it will not have any associated AUX files and you 
have to use the internal documentation in the EXEC to determine the PTF-numbered version to 
use. Do not depend on date and time stamps; examine the actual files. Each file ends with an 
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update summary that indicates the file’s service history. The latest version is the one with the 
most service. Files with filetypes of EXCnnnnn and XEDnnnnn are exact images of the 
corresponding EXEC and XEDIT executables. 


Copy the PTF-numbered version that you just selected to its executable filetype on the alternate 
DELTA disk. This step does not apply to those EXECs that you regenerated with the EXECUPDT 
command. 


copyfile / = EXEC fm (olddate replace Enter this command on the filelist screen next to 
the file you want to copy. fm is the alternate 
DELTA disk (593). 


Press PF2 to refresh the screen to verify that your changes have been made. 
Copy the new executable version of the module to the appropriate build disks: 


— If an executable version (with filetype EXEC) exists on the BUILD1 disk, copy the new version 
there. 


— If an executable version exists on the TASK disk, copy the new version there. 
— If an executable version does not reside on one of these disks, refer to the documentation 


supplied with the PTF to determine where it should reside. 


copyfile / = = fm2 (olddate replace @ Enter this command on the filelist screen next to 
the file you want to copy. You are copying 
these files from the alternate DELTA disk (593) 
to the BUILD] disk (490), the TASK disk 
(SES), or both. 


Use filemode 2 for files copied to the BUILD 1 
disk so they can be seen by other users. 


Press PF2 to refresh the screen to venfy that your changes have been made. 
Return to the original filelist screen using PF3. 


When you have processed each file in the original filelist screen, use PF3 to exit filelist. 


4. Repeat substep 3 for XEDIT macros. Replace EXEC with XEDIT and EXCannnn with XEDnnnnn. 
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Step 5. Test and Rebuild CMS 


Perform Steps 10, 13, 15, 16, and 17 of Chapter 14, “Rebuilding CMS after Applying Service” on page 431, 
to make the files on the 490 disk available to users. 


Step 6. Back Up the Dump Viewing Facility 


Use the procedure in Step 31 of Chapter 2, “Installing VM/XA System Product Release 2.1 with the Starter 
System (First Level)” to back up the dump viewing facility. 


This is the end of the service procedure for the dump viewing facility. 
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Chapter 17. Service to GCS 


This chapter describes: 


¢ Receiving PUT or COR service for GCS 
¢ Applying PUT or COR service to GCS 
¢ Rebuilding GCS. 


Should You Be Doing This Now? 


e Have you done the preparation steps in Chapter 9, “Preparing For Service” on page 415? If not, do so 


now. 


¢ Otherwise, continue with this chapter. 
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Step 1. Receive Service 


Note: If you are using ServiceLink to receive service electronically, use the procedure in Chapter 19, “Using 


ServiceLink to Receive Service” on page 533. 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 gcs @ 


. Attach a tape drive to MAINT: 


attach vdevno * 181 


. Mount and ready the PUT or COR tape. 
. Map the PUT or COR tape and receive the documentation. Mapping the tape means verifying that all 


the necessary files exist. Enter: 


release c VMFREC INFO (MEMOS xxx loads documents 
Ready; T=n.nn/n.nn hh:mm:ss to your C-disk if 1t is accessed, otherwise to your 
A-disk. 
vmfrec info (memos xxx Ml xxx 1s put if you are mapping a PUT tape, or cor 
DMSREC1852I This is n of n, if you are mapping a COR tape. If the tape you 
level level {PUT|COR} tape mounted is not the type of tape you specified, you 


receive an error message. 


VMFREC INFO (MEMOS maps the tape and 
loads the tape map, PUT DOCUMENT or COR 
DOCUMENT, and the Memo to Users (56643089 
MEMO) to your A-disk. Read these documents 
before going on. Print the documents to save a 
record of them. If you do not save a copy of 
these documents, they will be over-written the next 
time you receive a PUT or COR tape. 


If your system default language is uppercase 
American English, you may get message 
DMSMGMS8I4E. This message is caused by a 
problem with the REXX date function. You can 
ignore it. 


Ready; T=n.nn/n.nn hh:mm:ss 


. Review the receive exception log (SVMFREC $ERRLOG) to be sure that the MEMOs were loaded 


correctly: 


vmfview receive 


. Receive the service files to the target minidisks you specified in the product parameter file. Enter: 


vmfrec 56643089 gcs (xxx Wl xxx is put for a PUT tape, or cor for a COR tape. 
If you need to invoke an override file, substitute 
that file’s name for 56643089. 
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DMSREC1852I This is n of n, 
level level {PUT|COR} tape 
DMSREC1806I The current Service Diskmap contains 
the map of the mounted tape 


DMSREC1869R 56643089 GCS begins on {PUT|COR} If you do not have the correct volume mounted, 
level volume vol. Mount mount it now. 


correct volume and press ENTER The VMFREC EXEC loads the service files to the 


? i a target minidisk. 


DMSREC1852I This is n of n, 
level level {PUT|COR} tape 
DMSREC1806I The current Service Diskmap contains 
the map of the mounted tape 
DMSREC1804I Receiving service for component GCS 
of product 56643089 


Ready; T=n.nn/n.nn hh:mm:ss 


. Review the receive exception log (SVMFREC $ERRLOG), and correct any problems before continuing: 


vmfview receive 
Ready; T=n.nn/n.nn hh:mm:ss 


| | To Receive More Than One COR Tape | 


If you want to receive additional COR tapes at this time: 


1. You must suppress the automatic merging that occurs before a receive. Read “Preventing Automatic 


Merging” in Appendix G, “Controlling Disk String Merges” on page 861 and choose a method of 
preventing automatic merging. 


. For each COR tape you want to receive, repeat substeps 3 —7. 


. Create an apply list for the VMFAPPLY EXEC to use that contains the PTFs from all the COR tapes 


you just received: 


listfile csixa $apc* fm jm is the alternate DELTA disk (896). 
CSIXA $APCALL fm 
CSIXA $APCO109 fim 
CSIXA $APCO119 fm 
CSIXA $APCO126 fm 
CSIXA $APC9C22 fm 


xedit csixa $applist fm Edit the CSIXA $APPLIST file on the alternate 
get Sapcymdd DELTA disk. This file will already contain the 
file @ apply list from the last tape that you loaded. Do 


a GET command in XEDIT once for each CSIXA 
$APCymdd file shown by your LISTFILE 
command. 


Note: If the VMFAPPLY EXEC encounters duplicate entries for the same PTF, it issues a message 
telling you that the PTF has already been applied. This is an informational message; you can 
ignore it. 
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| 4. Create an exclude list for the VMFAPPLY EXEC to use that contains the excluded PTFs from all the 


| COR tapes you just received: 


| Note: Do not be concerned if the exclude lists are empty. 


listfile csixa $exc* fm Hi 


| 

| CSIXA 
| CSIXA 
| CSIXA 
| CSIXA 
| CSIXA 


file @ 


$EXCALL fm 
$EXCO109 fm 
$EXCO119 fm 
$EXCO126 fm 
$EXC9C22 fm 


xedit csixa $exclist fm Mi 
get $excymdd 


fm is the alternate DELTA disk (896). 


Edit the CSIXA $EXCLIST file on the alternate 
DELTA disk. This file will already contain the 
exclude list from the last tape that you loaded. 
Do a GET command in XEDIT once for each 
CSIXA $EXCymdd file shown by your LISTFILE 
command. 


| PO End of To Receive More Than One COR Tape ee 
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Step 2. Apply the Updates 


I. 


Consult your IBM service representative for the appropriate preventive service planning (PSP) bucket for 
your system’s VMSUP level and PUT level. Check the bucket and add the appropriate entries to the 
exclude list. The exclude list is called CSIXA $EXCLIST. 


Note: If two PTFs are in the same text deck, you cannot exclude the first unless you also exclude the 
second, even if you list the first one on the exclude list. This restriction applies because the first 
PTF is considered to be a prerequisite for the second PTF. 


If you list the first PTF in the exclude list, but not the second, and if the second PTF appears in 
the apply list, both PTFs will be applied. You will receive an error message indicating that a PTF 
you wanted to exclude has been applied. 


. Establish the appropriate minidisk access order: 


vmfsetup 56643089 gcs @ 


. Apply the service, that is, create auxiliary control files: 


vmfapply 56643089 gcs (xxx I xxx 1s put for PUT service, or cor for COR 
DMSAPP1853I Processing PTF ptfnum service. 


Ready; T=n.nn/n.nn hh:mm:ss 


. Review the apply exception log (SVMFAPP $ERRLOG), and correct any problems before continuing. 


The information in the apply exception log is used later when you rebuild the dump viewing facility. 


vmfview apply @ If you receive message number DMSAPP1885W, 
VMFAPPLY has applied service to a module for 
which you have a local modification. 


You can use the PF keys with the VMF VIEW 
EXEC to get useful lists of information. If you 
position the cursor on a line that contains message 
1885W and press PF2, VMF VIEW displays all the 
occurrences of message 1885W. Similarly, if you 
press PF6, VMFVIEW displays all the messages 
with the BD: prefix. You can use the XEDIT 
PUT command to save these messages in a file for 
future reference. 


Decide what you want to do with the local modification: 


e To remove a local modification, see Chapter 20, “Receiving and Applying Local Service” on 
page 543, and Chapter 22, “Removing Service from VM/XA SP” on page 559. 


e To rework a local modification, see Chapter 20, “Receiving and Applying Local Service” on 
page 543. 


¢ To keep a local modification, do nothing now. You will regenerate the part to pick up the local 
modification when you rebuild GCS. 


Save the names of all the parts for which you have both local modifications and IBM service. You will 
need the part names later when you rebuild GCS. 


Whether you remove, rework, or keep local modifications, you do not have to reissue VMFAPPLY. 
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Step 3. Build a New GCS Macro Library 


Note: This step describes a method of updating the GCS macro libraries that isolates all of the serviced 
macros and control blocks into a separate MACLIB using the VMFMAC EXEC. The new 
MACLIB is added to the MACS record in the CSIXA CNTRL file. 


An alternate method of updating the GCS macro libraries is to update each affected MACLIB 


with the changed macro or control block by using the MACLIB command. (See VM/XA SP 
CMS Command Reference for details on the MACLIB command.) 


If you choose the alternate method of building new GCS macro libraries, do so now and continue 
with “Step 4. Update the GCS Message Repository” on page 525. 


Note: If you want to rebuild the entire CSISP MACLIB, you must have the GCS SOURCE feature tape. 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 gcs @ 


2. Determine the macros and control blocks you have service for: 


e Search the DELTA string for all macros and control blocks you have service for: 


listfile * A*CI fml (exec args fname fm! is the alternate DELTA (896) disk. 

listfile * A*CI fm2 (append args fname fm2 is the intermediate alternate DELTA (791) 
disk. 

listfile * A*CI fm3 (append args fname @ Jm3 is the current DELTA (596) disk. 


e Ifa CMS EXEC does not exist on your A-disk after these commands, no serviced macros or control 
blocks were found on the DELTA string. Continue with substep 3. 


e Save the filenames in the GCSUPDAT EXEC and erase the CMS EXEC: 


copyfile cms exec a gcsupdat = = (replace @ 
erase cms exec a @ 


e¢ Determine which of the updated files are macros (filetype MACRO), and which are control blocks 
(filetype COPY). Store the results in the GCSNEW EXEC: 


gcsupdat listfile % macro * (append args ftype @ 


gcsupdat listfile % copy * (append args ftype MJgnore the messages that appear on your screen 
while these two commands are processing. 


e Ifa CMS EXEC does not exist on your A-disk after these commands, no serviced macros or control 
blocks were found on the DELTA string. Continue with substep 3. 


e Save the filénames in the GCSNEW EXEC: 


copyfile cms exec a gcsnew = = (replace @ 
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e Edit the GCSNEW EXEC to remove any duplicate entries: 


xedit gcsnew exec Hf 
sort * 115 @ 


file 


3. Determine the macros and control blocks for which you have local service. Follow your installation’s 
naming conventions for locally serviced files. Locally serviced files should reside on the LOCAL! disk 
string. 


¢ If no macros and control blocks have local service, continue with substep 4. 


¢ Otherwise, add your locally serviced macros and control blocks to GCSNEW EXEC. When you are 
done, the GCSNEW EXEC should list all macros and control blocks for which you have received 
IBM service (if any), plus any macros and control blocks for which you have local service. 


If you do not have a GCSNEW EXEC on your A-disk, copy the CSIGPI EXEC to use as a 
template: 


copyfile csigpi exec fm gcsnew = a (recfm f lrecl 80 & 


If you created the GCSNEW EXEC by copying the CSIGPI EXEC, use the contents of the CSIGPI 
EXEC only for a guide to the format of the entries. After you have added the macro and control 
block names you need, in the proper format, delete the macro names that originated from the 
CSIGPI EXEC: 


xedit gcsnew exec a Ml 
file 


4. If you have no updated macros or control files at this point, continue with “Step 4. Update the GCS 
Message Repository” on page 525. 


5. Generate the new macro library on your A-disk (191) by using the VMFMAC EXEC: 
vmfmac gcsnew csixa Mf 
DMSUPD178I Updating macroname MACRO fm 
DMSUPD178I Applying macroname update fm 
macroname MACRO ADDED 


Ready; T=n.nn/n.nn hh:mm:ss 


6. The contents of GCSNEW COPY were appended to GCSNEW MACLIB. You can now erase 
GCSNEW COPY (a file created by VMFMAC) on your A-disk (191): 


erase gcsnew copy a @ 
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7. Add the new macro library name to the TEXT MACS card in the CSIXA CNTRL file. 


List the new macro library first so that you use the updated macros. If you have already done this 
during previous service to GCS, you do not have to do this now. 


xedit csixa cntrl fm @ fm is the GCS BASE] disk (595). 
locate/TEXT MACS 

TEXT MACS maclib ... 

change/MACS/MACS GCSNEW/ @ 

TEXT MACS GCSNEW maclib ... 

file @ 


8. Copy the changed files from your A-disk to the GCS database: fm is the alternate DELTA disk (896) if 
you have no local service to the macros or control blocks. fim is the alternate LOCAL disk (495) if you 
have any local service to the macros or control blocks. 


copyfile cmsnew exec a = = fm (olddate replace @ 
copyfile cmsnew maclib a = = fm (olddate replace @ 


9. To make the MACLIB you just created available to general users, copy it from the GCS database to 
your GCS alternate BUILD1 disk (895): 


copyfile gcsnew maclib origin-fm = = target-fm2 (olddate replace 
origin-fm is the disk you copied the changed files 


to in the previous substep. target-fm is the GCS 
alternate BUILD] disk (895). 


10. Erase the working copies on your A-disk: 
erase gcsnew exec a 


erase gcsupdat exec a 
erase gcsnew maclib a @ 
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Step 4. Update the GCS Message Repository 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 gcs @ 


2. Determine your system default national language: 


query lang 


langid See Table 5 on page 311 to identify the language 
corresponding to /angid. Note the country code 
for that language. 


3. Invoke the VMFNLS EXEC to update the GCS message repository: 


vmfnis csimesy repos 56643089 gcs Mf y is the country code for your system national 
Ready; T=n.nn/n.nn hh:mm:ss language. 


4. If you have updates to the message repositories for any other national languages installed on your 
system, repeat substep 3 for each language. 


5. Copy the changed files from your A-disk to the GCS database: fm is the alternate DELTA disk (896) if 
you have no local service to the macro or copy files. fm is the alternate LOCAL disk (495) if you have 
any local service to the macro or copy files. 


copyfile csimesy {text|txtnnnnn\ a = = fm (olddate replace 
copyfile csimesy listing a = = fm (olddate replace Ml 


6. Erase the working copies on your A-disk: 


erase dmscsiy {text|txtnnnnn' a Hf 
erase dmscsiy listing a @ 
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Step 5. Assemble and Build the GCS Nucleus 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 gcs 


2. If you did not create the TESTNSS EXEC in “Step 9. Create Test EXECs and Files” on page 451 of 
Chapter 14, “Rebuilding CMS after Applying Service,” do so now. 


3. Define a new named saved system with an alternate name: 


testnss altsysname @ altsysname is an alternate name for your GCS 
system (for example, ALTGCS). 


HCPNSD440I The Named Saved System (NSS) altsysname 
was successfully defined 
in fileid fileno. 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) A-onnnn mm/dd hh:mm:ss CMS NSS MAINT 
*NSS nnonn NSS A_nnnn am/dd hh:mm:ss CMSXA NSS MAINT 
*NSS nonn NSS) S_ nnnn mm/dd hh:mm:ss altsysname NSS MAINT 


4. Create a configuration file for the GCS system you are servicing: 


copyfile gcs group fm altsysname = = (replace HM fm is the GCS LOCALI disk (495). 
xedit altsysname GROUP & 

locate /SYSNAME= @ 

change /SYSNAME=sysname/SYSNAME=altsysname/ @ 

locate /SEGMENTNAME= @ 

change /SEGMENTNAME=sysname/SEGMENTNAME=altsysname/ 

file 


5. Create an ASSEMBLE file for the GCS system you are servicing: 


copyfile altsysname group fm = assemble = (replace @ 


fm is the GCS LOCALI disk (495). 


6. Use the VMFHASM EXEC to update and assemble the ASSEMBLE file: 


vmfhasm altsysname 56643089 gcs 


DMSUPD181E No update files were found These are informational messages. You can 
ASSEMBLING altsysname ignore them. 
*** altsysname TEXT CREATED! *** 
PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 
Ready; T=n.nn/n.nn hh:mi:ss 


7. Copy the TEXT file from your A-disk to the alternate LOCALI disk: 


copy altsysname text a = = fm (replace fm is the GCS LOCAL] disk (495). 
Ready; T=n.nn/n.nn hh:mm:ss 
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10. 


11. 


12; 


. Issue the following commands: 


change rdr class n class m & 
Ready; T=n.nn/n.nn hh:mm:ss 

spool pun * class n nocont noeof @ 
Ready; T=n.nn/n.nn hh:mm:ss 

spool rdr class n keep 

Ready; T=n.nn/n.nn hh:mm:ss 

close pun @ 

Ready; T=n.nn/n.nn hh:mm:ss 


for the system you are now servicing: 


xedit gcsload EXEC Hf 


locate /& GCS 
change /&3 GCS/&3 altsysname/ @ 
file Hi 


Invoke VMFBLD to build the GCS nucleus: 


vmfbld 56643089 GCS (punch 
vinfbld 56643089 alisysname (punch @ 


000001 FILE CHANGED 
LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


RDR FILE filenol SENT FROM MAINT PUN AS fileno2 


RECS nnann COPY 001 N NOHOLD NOKEEP 


. XEDIT the GCSLOAD EXEC so that it will pick up the text deck you created in substep 6 on page 526 


If you have already edited GCSLOAD EXEC to 

service another GCS system, you must locate and 
change the altsysname for that system instead of 

GCS. 


Note: Use this command if you created a PPF 
override file to maintain more than one 
GCS system. 


Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build 


Issue the following commands: 


spool pun off eof &@ 

Ready; T=n.nn/n.nn hh:mm:ss 
close rdr @ 

Ready; T=n.nn/n.nn hh:mm:ss 
spool rdr class n keep @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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13. IPL your reader to save the new GCS system in the named saved system you created: 


ip] 00c clear Hf 
MSG FROM MAINT: CSIIN134I altsysname has nnnnnn 
bytes of available common free storage 
HCPNSD440I The Named Saved System (NSS) altsysname 
was successfully defined in fileid fileno 


PRT FILE filenol SENT FROM MAINT RDR AS fileno2 This printer file is the GCS load map. Note the 
RECS nnnn COPY 001 N NOHOLD NOKEEP second file number. 
System reset 


14. IPL CMS (or ALTCMS): 


ip] {cms|altcms} @ 

VM/XA CMS 5.6 mm/dd/yy hh:mm 
a 

Ready; T=n.nn/n.nn hh:mm:ss 


15. Save and print the GCS load map: 


#cp transfer prt fileno2 to * rdr @ fm is the GCS LOCALI disk (495). 
vmfsetup 56643089 gcs 
receive fileno2 gcsnuc map fm @ 


You can assign any filename and filetype to the load map. You may want to adopt a naming convention 
for the load maps, to save the map from each build. For example, you can name each map in the format 
compnamemap ymdd to distinguish each build. 


Notes: 


a. ymdd represents the date in four digits: last digit of the year, month (represented as | —9, A, B, C), 
and day. 


b. Nucleus maps are very large. You may have to save old maps on another disk. 


Once you have the load map saved on disk, you can print a copy of it by issuing the following command: 


print gcsnuc map fn Wf fmis the GCS LOCAL] disk (495). 


| Maintaining More Than One GCS System | 


16. You can maintain multiple GCS systems using the technique described below for each GCS system. 
Each GCS system must have a unique name and must be targeted to a different BUILD disk. 


To use different BUILD disks (BUILDn) for each nucleus, you should create an override to the product 
parameter file for each nucleus you are maintaining. In the override file, change the BUILDn target. 
Each override file should have a unique filename and a filetype of PPF. 


A sample override file follows. 
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| * This is the alias override for the VM/XA System Product 56643089 
sOVERLST. altsysname CORaltsysname 

| * 

| saltsysname. GCS 56643089 * PUT Service 
| :BLD. 

| GCSLOAD VMFBDNUC BUILDn 

| sEND. 

| * 

| :CORaltsysname. GCS 56643089 * COR Service 
| sMERGE. APPLYX DELTAX 

| :MDA. UPDATE 

| APPLYX 892 491 

| DELTAX 896 791 

| :BLD. 

| GCSLOAD VMFBDNUC BUILDn 

| END. 


| Po End of Maintaining More Than One GCS System ees: 
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Step 6. Test and Rebuild CMS 


Perform Steps 10, 13, 15, 16, and 17 of Chapter 14, “Rebuilding CMS after Applying Service” on page 431, 
to make the files that VMFBLD EXEC loaded to the 490 disk in Step 5 available to users. 


Step 7. Test and Rebuild the GCS Nucleus 


Test the GCS nucleus you just built. When you are satisfied, repeat Step 5 to rebuild the nucleus with its 
original name. 


Step 8. Back Up the GCS Named Saved Systems 


Use the procedure in Step 30 of Chapter 2, “Installing VM/XA System Product Release 2.1 with the Starter 
System (First Level)” to back up the GCS named saved systems. 


This is the end of the service procedure for GCS. 
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Chapter 18. Program Update Service to Licensed Programs 


This chapter describes how to apply program update service to licensed programs that have a product 


service EXEC rather than a product parameter file. 


To apply service to licensed programs, refer to the publications for the specific licensed program. If the 
licensed program has a product parameter file, the general concepts described in this book for program 
update service are applicable. To apply corrective service, see the publications for the specific licensed 
program. 


If the licensed program has a product service EXEC, the following general procedure is applicable. 


1. Attach a tape drive to MAINT: 


attach vdevno * 181 


2. Mount and ready the PUT tape. 


3. Map the PUT tape and receive the documentation. Mapping the tape means verifying that all the 
necessary files exist. Enter: 


release c @ VMFREC INFO (MEMOS xxx loads documents 
to the C-disk if it is accessed, otherwise to the 
A-disk. You want them loaded to the A-disk. 


vmfrec info (memos put @ If the tape you mounted is not a PUT tape, you 
DMSREC1852I This is n of n, recelve an error message. 


peveymerenivul eRe VMFREC INFO (MEMOS maps the tape and 
loads the tape map, PUT DOCUMENT, and the 
Memo to Users (56643089 MEMO) to your 
A-disk. Read these documents before going on. 
Print the documents to save a record of them. If 
you do not save a copy of these documents, they 
will be over-written the next time you receive a 
PUT tape. 


If your system default language is uppercase 
American English, you may get message 
DMSMGMS8I4E. This message is caused by a 
problem with the REXX date function. You can 
ignore it. 


Ready; T=n.nn/n.nn hh:mm:ss 


4. Review the receive exception log (SVMFREC $ERRLOG) to be sure that the MEMOs were loaded 
correctly: 


vmfview receive Hi 
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5. Receive the service files to the target minidisks you specified in the product parameter file. Enter: 


vmfrec prodid parameters @ VMFREC invokes the product service EXEC to 
receive and apply service. You can pass 
parameters to the product service EXEC. 


6. Review the receive exception log (SVMFREC $ERRLOG), and correct any problems before continuing: 


vinfview receive @ 
Ready; T=n.nn/n.nn hh:mm:ss 


7. Check the Program Directory for the licensed product (not the VM/XA SP Program Directory) or other 
licensed program documentation to see whether the product service EXEC, which VMFREC invoked for 
you in step {RAPROD}, builds the licensed program. For most products, it does. If it does not, invoke 
VMEBLD to build the licensed program: 


vmfbld prodid parameters VMFBLD invokes the product service EXEC with 
the BUILD parameter. The product service 
EXEC then rebuilds any part of the licensed 
program changed by service that requires a build 
function. You can pass parameters to the product 
service EXEC. 


8. Review the build exception log (SVMFBLD $ERRLOG), and correct any problems before continuing: 


vmfview build 


Note: For compatibility, the VMSERV EXEC continues to be available to service this type of licensed 
program. 
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, Chapter 19. Using ServiceLink to Receive Service 


Before You Begin: 


This chapter is for VM/XA System Product Release 2.1 users who have the IBMLink and ServiceLink 
products. ServiceLink is a part of IBMLink that lets you access IBM software service information online. 
You must be authorized to use IBMLink and ServiceLink. In addition, you must be authorized to order 


service and receive it electronically using ServiceLink. The information in this chapter must be used in 
conjunction with the ServiceLink User's Guide, SH52-0300. The ServiceLink User’s Guide provides 
information on retrieving and decompacting the envelope file on your A-disk. When this process is 
completed, continue with “Step 1. Load the Documentation Envelope” on page 539 for the procedures 
to receive the service from ServiceLink. 


| The ServiceLink Envelope File 


| When you receive service through ServiceLink, the storage medium for the service is a CMS disk file rather 
| than tape. This CMS disk file, called an envelope file, contains other (one or more) disk files that can be 
| further separated into groups of files for processing. The following terminology is used in this chapter: 


| Envelope File A CMS disk file that contains the individual files that are to be loaded or otherwise 
| processed. 


| File (or Disk File) The individual files that are contained within the envelope file. Each file within the 
| envelope consists of a header record, which contains information to identify the file, 
| and one or more data records containing the contents of the original file. 


| Header Record A special record in the envelope file that contains the file identifier for the file, 

| date/time stamp information, and other information needed to load the file. 

| Data Records The actual data from the file in the format used by the CMS COPYFILE command. 

| Group Separator A special record in the envelope file that marks the boundary between groups of files. 
End of Disk The logical end of the contents of the envelope file. This condition occurs when two 


two group separator records at the physical end of the envelope, VMFPLCD will 


| 
| successive group separator records are encountered. If the envelope does not have 
| 
| process the file as if they exist. 


| Envelope File Description 


| There are two basic types of envelope files shipped by ServiceLink: documentation envelopes and the 

| envelope containing the actual fixes. Additionally, each envelope maybe in two different formats and is 

| processed by different commands, VMFREC and VMFPLCD. Following are examples of the different types 
| of envelope files that may be received from ServiceLink and the command used to process it. 
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COR 9991 <=== COR Descriptor File 
COR VMELESES <=== COR Content and Instructions 
momeemmrmomsmorses Group Separator menccmircscssersssass 
(||| tice esos Sosa ttl oe et Sek eee euleseseeeeeeseeseaeesoee= 
| | ---GROUP FILE 2 --- 
[. | Setebebtbeebscscescecscteuusecoda sees seas tea sssensestsoeeeseceessase: 
| } prodidl crlinnl <=== Program Level File 
| | prodid! MEMO <=== Instructions for product 
| | prodidl $CORymdd <=== Product Contents Directory 
| | prodid2 crillnnQ 
| | prodid2 MEMO 
| | prodid2 $CORymdd 
| | prodid3 crilnnf . 
| | prodid3 MEMO 
| | prodid3 $CORymdd 
| | prodid4 crlinnf 
| | prodid4 MEMO 
prodid4 $CORymdd 


| mosmsmmcocmocmssasessscacsSsss Group Separator momommsesssStosssse 
connnunccncsasmsmmsssssss= Group Separator sssss===ss=sscsssscc= 


| Figure 30. Example of an Envelope File in VMFREC Format. This envelope file has a filetype of VLSTnnnn and 
| contains service documentation. 


<=== COR Content and Instructions 
Group Separator 
Group Separator 


| Figure 31. Example of an Envelope File in VMFPLCD Format. This envelope file has a filetype of VLSTnnnn and 
contains service documentation. 
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—L ame ae eee eee eee eee 


COR 9901 <=== COR Descriptor File 

COR VMELEMIX <=== Pointer to Instructions in VLSTnnnn 
SSSSSSsSSeeVsSsaaeSSsssssa Group Separator SRSSclaesssssasssso= 

| ---GROUP FILE 2 --- | 

prodidl crlinnl <=== Program Level File 

prodidl MEMO <=== Pointer to Instructions in VLST 

prodid! $CORymdd <=== Product Contents Directory 

prodid2 crlinnO 

prodid2 MEMO 

prodid2 $CORymdd 

prodid3 crilinnf 

prodid3 MEMO 

prodid3 $CORymdd 

prodid4 crlinnf 

prodid4 MEMO 

prodid4 $CORymdd 


= Group Separator s==ss=ccnccacesecsons 


Flag byte 1 indicates new format 
LSS lea VSS SSS SST SSS SSS SSS G ro up S epa rat 8] ff SSScssasSscscssl Sloe 


COMP1 PART1A <=== Group processed according to Part 1 
COMP1 PART1B as described in PPF in terms of process 


COMP1 PARTIC destination. 
COMP1 PART1D 


COMP1 PARTZE 
COMP1 PART2F 
COMP1 PART2G 

Coors SrSSSSssrss Group Separator Soom 


Figure 32 (Part 1 of 2). Example of an Envelope File in VMFREC Format 


Chapter 19. Using ServiceLink to Receive Service 


535 


es ce ce cee re eee eee eee eee ee oe 


— = see eee eee eee eee eee ee 


COMP1 PART3H <=== Processed according to Part 3 in PPF 
SScsisssaescsocscssssessosoom Group Separator Socmemescenscssssecsses 


COMP2 PARTIA <=== Processed according to Part 4 in PPF 
COMP2 PARTIB 


COMP2 PART2C <=<c= Processed according to Part 5 in PPF 
COMP2 PART2D 
COMP2 PART2E 
COMP2 PART2F 
COMP2 PART2G 
IoGHSssmeerKcocssmsesssoss Group Separator SScscocecoccmSssmss 


prodid2 criinn0d <=== Flag byte 0 indicates compatible 
format 

Soma messeesssseessss Group Separator masesesescosessssess= 
| --- File 2 - PTFs --- | 
prodid2 EXEC <sc= Rename EXEC for Product 2 
COMP1 PARTIA <=== Group processed by product exec 
COMP1 PART1B 
COMP1 PARTIC <=== Group processed by product exec 


COMP1 PART1D 
COMP1 PARTIE 
COMP1 PARTIF 


sSnosSsosmamessessncssessoens Group Separator srooessossmmssocsoss 
SSS SSS SSS LSS LS LS SS SSS SSS SS Group Separator SSS SSS SSS SSS 
Somcmmssonccsssssamssscoss Group Separator =ssssssessseccssssa= 


Figure 32 (Part 2 of 2). Example of an Envelope File in VMFREC Format 
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VMELEDOC DOCUMENT <=== Pointer to Instructions in VLSTnannn 
omomcssomsssasocnsscocossss Gro up Sepa rator 


---GROUP FILE 2 --- 
--- Product 2 - PTFs 


prodid2 EXEC <=== Rename EXEC for Product 2 

COMP1 PARTIA <=== Group processed by product exec 
COMP1 PART1B 

COMP1 PART1C 

COMP1 PART1D 

COMP1 PARTIE 

COMP1 PARTIF 


-~-GROUP FILE 3 --- 
--- Product 3 - PTFs 


prodid3 EXEC <c== Rename EXEC for Product 3 

COMP1 PARTIA <=== Group processed by product exec 
COMP1 PART1B 

COMP1 PARTIC 

COMP1 PART1D 

COMP1 PARTIE 

COMP1 PART1F 


| Figure 33. Example of an Envelope File in VMFPLCD Format. This envelope file has a filetype of VPTFnnnn and 
| contains the actual fixes for two products. 


CRLLNNF - C = COREQ Flag 
R = Release Level of product or SCP 
LL= PTF Level of Product or PLC level SCP 
NN= Total number of Group Separators for this Product 
F = 1 indicates new format, 0 indicates compatible format 


| Figure 34. Definition of a Program Level Filetype. The CRLLNNF filetype is used to determine the type of receive 
| processing that is required for the product. A 1 in the F field indicates that the product is supported by 
| VMFREC. 
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Tools Used With ServiceLink 


To receive service with ServiceLink, you use one or more of the following EXECs: 


¢ For envelopes in VMFREC format, use the VMFREC EXEC. The format of the VMFREC EXEC is 
described in “VMFREC EXEC” on page 691. 


e For envelopes in VMFPLCD format, use the VMFPLCD EXEC. The VMFPLCD EXEC reproduces 
the functions of the VMFPLC2 EXEC, except that the storage medium is disk rather than tape. The 
commands, functions, parameters, and options resemble the VMFPLC2 EXEC as closely as possible. 
The format of the VMFPLCD EXEC is described in “VMFPLCD EXEC” on page 681. 


An additional EXEC, the VMFPLC EXEC, is provided to minimize impacts to existing code currently using 
VMFPLC2. The VMFPLC EXEC calls either the VMFPLC2 EXEC or the VMFPLCD EXEC depending 
on the routing in effect. The default routing of commands from VMFPLC is to the VMFPLC2 EXEC. You 
can still invoke VMFPLC2 or VMFPLCD directly from the command line as well. 


The format of the VMFPLC EXEC is described in “VMFPLC EXEC” on page 679. The format of the 
VMFPLC2 EXEC is described in “VMFPLC2 Command” on page 687. 
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| Step 1. Load the Documentation Envelope 


| 1. Follow the procedures in the ServiceLink User’s Guide to retrieve and uncompact the envelope file on 
| your A-disk. 


| Note: If the filetype of your VLSTnnnn and VPTFnnnn envelope files is not SERVLINK, retain the 
| filename but change the filetype to SERVLINK. 


| 2. Use XEDIT to edit the documentation envelope you have on your A-disk, and check the filename of fn 
| MEMOS. If the filename is VMELESES or VMELEMIX, continue with “Step 2. Receive the Service 
| Envelope (VM/XA System Product Release 2.1 Only)” on page 540. If the filename is anything else, 

| continue with “Step 3. Receive the Service Envelope (Other Program Products)” on page 541. 


| x vistnnnn servlink @ 
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| Step 2. Receive the Service Envelope (VM/XA System Product 
| Release 2.1 Only) 


l. 


540 


Receive the service documentation relating to PTF files from the VLSTnunn SERVLINK envelope: 


Note: You only need to do this operation once for each envelope file, no matter how many products or 
components are in each envelope file. 


vmfrec info env vistnnnn (memos COR @ The type of service you are receiving is considered 
to be COR service. 


VMFREC EXEC maps the envelope file (verifies 
that the necessary files exist) and creates a 
SERVICE DISKMAP file on filemode C (or A), 
loads the COR VMELESES or COR 
VMELEMIX documentation file to filemode C (or 
A), and loads the prodid MEMO files in the 
second group to filemode C (or A). 


Continue with substep 2. 


. Read the service file document to determine the products you want to service. Read the Memo to Users 


for each product you plan to service. 
Receive the service envelope: 
vmfrec 56643089 component env vtpfnnnn (cor Hf compname is the component you are receiving 


service for. The type of service you are receiving 
is considered to be corrective service. 


. Review the receive exception log (VMFREC $ERRLOG), and correct any problems before continuing: 


vmfview receive Hi 
Ready; T=n.nn/n.nn hh:mm:ss 


. When you are satisfied that the service has been received correctly, erase the S$VMFREC $HISTORY and 


$VMFREC $ERRLOG files on your A-disk. 


. Continue with the service process: 


e For CMS, continue with “What to Do Next” on page 421. 

e For CP, continue with “What to Do Next” on page 426. 

¢ For DV, continue with “Step 2. Apply the Updates” on page 511. 
e For GCS, continue with “Step 2. Apply the Updates” on page 521. 
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. Step 3. Receive the Service Envelope (Other Program Products) _ 


| 
| 


1. Reset to the start of the envelope and load the documentation envelope: 


vmfplcd rst env= vistnnnn servlink #f 
vmfplcd load * * a env= vistnnnn servlink (eod 


2. Read the service file document to determine the products you want to service. Read the Memo to Users 
for each product you plan to service. 


3. Receive the service for the product on a work disk. Refer to your product documentation for procedures 
to follow for installing corrective service. 


vmfplcd rst env= vptfnnnn servlink & 
vmfplcd scan prodid exec (eod @ 
vmfplcd load * * fm (disk @ 


4. To continue with the service process, consult the documentation provided with the product. 
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Chapter 20. Receiving and Applying Local Service 


This chapter describes step-by-step procedures for applying local service to all components of VM/XA 


System Product using update files. 


Introduction 


Local service is defined as any service that is applied to your VM/XA SP system that was not supplied by 
IBM on a COR tape, COR tape envelope (in SES format), or PUT tape. 


Warning: The application of local service can be a complicated and error-prone procedure because of the 
many variables that are involved. IBM strongly advises its customers to order service on a COR tape 
through the IBM Support Center whenever possible. When it is absolutely necessary to apply service from 
IBM before it is available on a COR tape, or a local modification is required to tailor a system environment, 
you must apply the service locally. This should be done very carefully. 


Note: Before attempting to apply local service, please read Chapter 6, “VM/XA System Product Service—An 
Overview,” Chapter 7, “How VM/XA System Product Uses Control Files and Update Files,” and 
Chapter 8, “Files Used in PUT and COR Service” of this book. It is very important to have a good 
understanding of how the service process works before you proceed with this chapter. 


Local service can be placed in two categories: 


¢ IBM local service includes any service that you receive from IBM that is not COR closed, such as 
emergency service from the change team. When a severe problem arises and you cannot wait for a COR 
tape, you can get emergency service from the change team. This service can be sent to you on a tape or 
read to you over the phone. In either case, the service is not in the format required by the VMFREC and 
VMFAPPLY EXECs. To receive and apply this service, you must do it manually using the instructions 
in this chapter. 


¢ Customer local service includes any service that is not supplied by IBM. Customer local service is used to 
tailor your VM/XA SP system. An example of customer local service is given in Step 17 of Chapter 2, 
“Installing VM/XA System Product Release 2.1 with the Starter System (First Level).” The example 
given shows how to tailor the HCPBOX ASSEMBLE file. To receive and apply this service, you must do 
it manually using the instructions in this chapter. 


The instructions in this chapter apply to all components of the VM/XA SP system (CMS, CP, DV, and 
GCS). Whenever there are variations for different components, they are noted. 
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Step 1. Preparation 


Before you service your VM/XA System Product Release 2.1 system, you should create an alternate level of 
build disks. Doing so isolates the changed system so it can be tested before you make it available to your 
general user community. 


1. Use the DASD DUMP Restore program to copy the current BUILD] disk to its corresponding alternate 


disk: 


ddr @ 


VM/XA SYSTEM PRODUCT DASD DUMP RESTORE PROGRAM 


ENTER: 


sysprint cons Hf 
ENTER: 


input 190 devtype MNT190 & 
ENTER: 


output 490 devtype MNT490 
ENTER: 


copy 000 endcyl 


DMKDDR711R Volid Read is MNT190. Do you 
wish to continue? 

yes Hf 

ENTER NEXT EXTENT OR NULL LINE: 

| 


END OF COPY 
ENTER: 

i 

END OF JOB 


. Re-label the 490 minidisk: 


access 490 t Hf 

Ready; T=n.nn/n.nn hh:mm:ss 
format 490 t (label @ 
ENTER LABEL: 

mnt490 @ 

Ready; T=n.nn/n.nn hh:mm:ss 


This command tells DDR to send program 
messages to your console. 


190 is your current CMS system disk. devtype is 
the device type of the DASD volume where 190 is 
located. 


490 is your alternate CMS system disk. devtype 1s 
the device type of the DASD volume where 490 is 
located. 


The value for endcyl depends on the device type of 
your 190 disk: 


Device Type endcyl 


3350 73 
3375 112 
3380 7) 
3390 67 


You have not yet changed the label of the 490 
minidisk. (You will do so in substep 2.) This 
prompt will not always appear. 


Access 490 after the system disk. You must use 
the label option. If you do not, you will erase all 
the files on the 490 minidisk. 


. Repeat substeps | and 2 to copy the current HELP disks (19D, 19C, 19B...) to their corresponding 
alternate disks (49D, etc.) and to re-label the alternate disks as MNT49n. Check the minidisk definitions 
in your user directory to find the appropmate value for endcy/. 
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Note: There is one HELP disk for each national language supported on your system. If you support 
only one national language, you only have to do this substep once. 
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Step 2. Preparation for CMS Local Service Only 


In order to be consistent with the philosophy of not building on top of your production system, you must 
perform the following steps before applying local service to CMS: 


1. Copy the latest version of the DMSNGP ASSEMBLE file to the 395 disk. (If there is already a copy of 
DMSNGP ASSEMBLE or DMSNGP TEXT on the 395 disk, rename it first.) Edit the copy and make 
the following changes: ; 


a. 
b. 
Cc. 


d. 


Change SYSDISK = 190 to SYSDISK = 490. 
Change IPLADDR = 190 to IPLADDR=490. 
Change HELP= 19D to HELP=49D (or HELP=19C to HELP=49C). 


Change SYSNAME=CMS to SYSNAME =newname, where newname is the name you choose for 


your test system. The sample procedure in Chapter 14, “Rebuilding CMS after Applying Service,” 
uses ALTCMS. 


. Change INSTSEG = CMSINST to INSTSEG =newname, where newname is the name you choose for 


your test installation segment. The sample procedure in Chapter 14, “Rebuilding CMS after 
Applying Service,” uses ALTINST. 


. Change the VERSION= and INSTID= parameters to identify your test system. 
. Make sure that SAVESYS=NO. If SAVESYS= YES, when you IPL CMS the system will try to 


save the alternate CMS segment that you define in Step 10 of Chapter 14, “Rebuilding CMS after 
Applying Service” in the existing CMS segment. 


These changes cause the new CMS nucleus (with service) to be built on the 490 minidisk. 
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Step 3. Receive Service 


1. Log on to MAINT and establish the appropriate minidisk access order: 


vmfsetup 56643089 compid & Substitute for compid the component you are 
Ready; T=n.nn/n.nn hh:mm:ss servicing (CMS, CP, DV, or GCS). 


2. Place the service that you receive in one or more CMS files on the alternate LOCALI1 minidisk. 


| Service Supplied on Magnetic Tape or Tape Envelope | 


If service 1s supplied on a magnetic tape, or in a tape envelope which you receive electronically, use 
VMFPLC: 


vmfplc lead * * fm(eot disk @ fm is the alternate LOCAL] disk for the 
component you are servicing. 


ae End of Service Supplied on Magnetic Tape or Tape Envelope ees 
| Service Supplied as Hard Copy or by Telephone | 


3. If service is supplied as hard copy or by telephone as the result of an emergency, your IBM Service 
Representative should supply you with the filename and filetype of each required file. Make a list of 
these names. You must now type in these files. Use the XEDIT command to create each CMS file on 
the alternate LOCAL] minidisk. 


a End of Service Supplied as Hard Copy or by Telephone ee 


Chapter 20. Receiving and Applying Local Service 547 


Step 4. Apply Service 


Changes to the system are provided as new parts, replacement parts, or updates to existing parts initially 
shipped on the product tape. The following table shows the base filetypes that might be serviced and how 
they are serviced (update or replacement): 


Table 14. Types of Files That Can Be Serviced 
Filetype 
TEXT 


Corresponding File Type of Service 
With corresponding ASSEMBLE 
Without corresponding ASSEMBLE 
With corresponding SEXEC 
Without corresponding $EXEC 
With corresponding $XEDIT 


Update 
Replacement 
EXEC Update 
Replacement 


XEDIT Update 


Without corresponding $XEDIT Replacement 
MACRO 
COPY 


Update 
Update 


Any other types Replacement 


For the following examples, assume that you have received emergency service from the change team. You 
have received one PTF, but it is not COR closed. A PTF 1s considered COR closed when it is made available 
for distribution on a COR tape. The PTF (UM34567) hits two modules, HCPABC and HCPXYZ. Also 
assume that you are creating customer local service for HCPQRS. These examples are for CP files, but the 
procedures for all components are the same. 


For the list of files that you are servicing, refer to the tape or disk map from the last step if you received 
service from tape or envelope, or to the list that your IBM Service Representative gave you if you received 
service as hard copy or over the telephone. 


1. Determine the base filetypes of HCPABC, HCPXYZ and HCPQRS. 


For each unique filename that you are servicing, issue the LISTFILE command. Using Table 14 and 
“VM/XA SP Filetypes and Abbreviations” on page 863 as a guide, write down what the base filetype is 
for each filename being serviced. 


listfile hcpabc * * Hf In this example, you can see both an ASSEMBLE 
HCPABC _A98765HP _fm file and a corresponding TEXT file. This indicates 
HCPABC AUXLCL = ffm that HCPABC is serviced by updates 

HCPABC LOQOOI1LC fm (source-maintained). 


HCPABC LCLOQ001 fm 
HCPABC AUXXA fim 
HCPABC Al2345HP fm 
HCPABC = TX1732123 fm 
HCPABC ASSEMBLE fm 
HCPABC ‘TEXT fim 
Ready; T=n.nn/n.nn hh:mm:ss 
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to 


listfile hcpxyz * * @ In this example, there is no corresponding 


HCPXYZ _TX134567__ fm ASSEMBLE file, so the base filetype is TEXT. 
HCPXYZ AUXXA fim This indicates that HCPXYZ is serviced by 
HCPXYZ A12345PP fim replacement (object-maintained). Do not be 
HCPXYZ TXT32123 fm confused by the update file HCPXYC A12345PP. 
HCPXYZ__ TEXT fm It is only an update shell. Update shells are 
Ready; T=n.nn/n.nn hh:mm:ss explained below. 

listfile hcpqrs * * In this example, there is an EXEC and a 

HCPQRS EXEC fim corresponding $EXEC. This indicates that 
HCPQRS _ $EXEC fm HCPQRS is source update serviced. 


Ready; T=n.nn/n.nn hh:mm:ss 


Use XEDIT to create an AUX file entry on the AUXLCL level. 


There are three fields that make up an AUX entry. The first field contains the filetype of the update file. 
Imbedded in this filetype is the 5-digit numeric portion of the APAR number. When you originate an 
update, this 5-digit number should be a local tracking number. The second field is the level of the fix. 
For local service, use LCL in this field. If you want to keep your IBM local service separate from your 
customer local service, you can use LCx in this field (x is any alphanumeric character). The third field is 
the PTF number or a local tracking number. 


a. If an AUXLCL file already exists, as in the case of HCPABC, copy it to the alternate LOCALI. 


copyfile hcpabc auxicl fml = = fm2 @ Substitute for fim/ the filemode of the minidisk 
Ready; T=n.nn/n.nn hh:mm:ss on which the AUXLCL file currently resides. 
fm2 is the LOCAL] minidisk. 


The existing HCPABC AUXLCL file has only one entry: 
LOQOO1LC LCL LCQOQO1 * CUSTOMER LOCAL SERVICE TO CIRCUMVENT A PROBLEM 


This is a locally originated fix. 00001 is your local tracking number. 


If the new fix from IBM fixes the problem you circumvented with the entry in the AUXLCL file, 
replace the entry in the AUXLCL file with the new one from IBM. Your new AUX entry in the 
AUXLLCL file is then: 


A98765HP LCL UM34567 * IBM UPDATE TO FIX THE PROBLEM 


If the new fix from IBM is unrelated to the entry that is in the AUXLCL file, you must review your 
previous customer local service and rework it if necessary. Put the AUX entry for the new fix below 
the existing AUXLCL entry in the file. Then use XEDIT with the CTL option to rework the old 
AUX entry. The new AUXLCL file would look like this: 


LOOOO1LC LCL LCQOQO1 * REWORKED CUSTOMER LOCAL SERVICE 
A98765HP LCL UM34567 * IBM UPDATE TO FIX A DIFFERENT PROBLEM 


b. If an AUXLCL file does not exist but another AUX file does (as in the case of HCPXYZ), you can 
copy and rename an existing AUX file to the alternate LOCAL] and use it as a guide: 


copyfile hcpxyz auxxa fml = auxlcl fm2 @ Substitute for fm/ the filemode of the minidisk 
Ready; T=n.nn/n.nn hh:mm:ss that the AUXXA file currently resides on. fm2 
is the LOCAL] minidisk. 
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For HCPXYZ, you have a replacement text deck. Use XEDIT to look at the self-documenting 
information at the top of the new text deck: 


xedit hcpxyz txt34567 fm The system displays a file like the one in 
Figure 35. fm is the LOCAL] minidisk. 


A12345PP 201 UM32123 * THIS IS AN OLD FIX 


* 


HCPXYZ A12345PP fm nnnnnn mm/dd/yy hh:mm:ss 


* PREREQ: NONE 
* CO-REQ: NONE 
* TF-REQ: NONE 
A98765PP xxx UM34567 * THIS IS THE NEW FIX 


* 


HCPXYZ A98765PP fm nonnnn mm/dd/yy hh:mm:ss 


* PREREQ: VM12345 
* CO-REQ: NONE 


* 


IF-REQ: NONE 


Figure 35. A Sample Replacement Text Deck (HCPXYZ TXT34567) 


In AUX files, the most recent entry is on top. In text decks, the most recent entry is on the bottom 
of the prolog. The first entry in the text deck 1s already in the HCPXYZ AUXXA file. The second 
entry is the new fix and requires that an AUX entry be made on the AUXLCL level. The AUX 
entry can be copied directly from the replacement text deck. The only change should be in the 
second field. As mentioned above, this field should be LCL, so the AUX entry in HCPXYZ 
AUXLCL should be: 


A98765PP LCL UM34567 * THIS IS THE NEW FIX 


. If no AUX files exist, as in the case of HCPQRS, use XEDIT to create one on the alternate 


LOCALI. 


For HCPQRS, there are no existing updates, so when you have finished editing the AUXLCL file, 
the only entry in it should be the update that you are creating: 


LOOOOZ2LC LCL LCQOQO2 * LOCAL FIX TO CIRCUMVENT A PROBLEM 


Note: This process would be the same for other parts, including the filetypes ASSEMBLE, $EXEC, 


$XEDIT, MACRO, and COPY. 


3. Create an update file or update shell. 


a. For HCPABC, IBM shipped you the update file for the fix. 
b. For HCPXYZ, IBM shipped you only a replacement text deck named HCPXYZ TXT34567. For 


this part, you must create an update shell. An update shell takes the place of the source update file 
that would exist if the part were on update service. Just as with the AUXLCL file for HCPXYZ, 
you can take the information for the update shell from the replacement text deck (see Figure 35). 
Your update shell for HCPXYZ should look like Figure 36. 


./ * PREREQ: VM12345 

./ * CO-REQ: NONE 

./ * IF-REQ: NONE 

./ * DEPEND: NONE 

./ * * THIS IS AN UPDATE SHELL 


Figure 36. A Sample Update Shell (HCPXYZ A98765PP) 
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c. For HCPQRS, you must create your own update file because it is originated locally. Normally, you 
would already know what kind of change you wanted to make to HCPQRS. To create the update 
file, you will invoke XEDIT with the CTL option: 


xedit hcpqrs $exec fm (ctl hcpxa @ If you receive message DMSXUPI178I, previous 
: updates are being applied before your new 

file update is created. You should receive message 
Ready; T=n.nn/n.nn hh:mm:ss DMSXUPI180W. This message tells you that 


your new update cannot be found. This 1s 
because you are in the process of creating it. At 
this point you can make your updates. 
Remember that these updates do not go into the 
$EXEC file, but instead are put in the HCPQRS 
L00002LC update file. 


Note: This process is the same for other parts, including files with the filetypes ASSEMBLE, $EXEC, 
$XEDIT, MACRO, and COPY. The CNTRL file vanes from component to component. See 
Chapter 7, “How VM/XA System Product Uses Control Files and Update Files” on page 361 for 
a description of the CNTRL files and to find out which one is appropriate for the service you are 
performing. 


4. Create executable parts. 
At this point, you should have a correct AUXLCL file and a corresponding update file or shell. 


a. For HCPABC, you still need a text deck. This text deck is generated when you assemble HCPABC 
during the rebuilding process after you have finished this chapter. 


b. For HCPXYZ, IBM supplied you with a replacement text deck. The text deck, however, is not 
named consistently with the AUXLCL entry that you created. You must now rename this text deck: 


rename hcpxyz txt34567 fm = 1c134567 = @ 
Ready; T=n.nn/n.nn hh:mm:ss 


c. For HCPQRS, you still need an EXEC. This EXEC is generated when you run EXECUPDT for 
HCPQRS during the rebuilding process, after you have finished this chapter. 


The following lists the base filetypes that may be included in your local service, along with a brief 
description of how the executable part is generated. 


¢ ASSEMBLE with a corresponding TEXT or TXTnnnnn: Update 
You reassemble this part during the rebuilding process. 
¢ TEXT or TXTnnnnn with no corresponding ASSEMBLE: Replacement 


You must rename the new TXTnnnnn file to LCLuannnn, where nnnnn is the PTF number: 


rename filename txtnnnnn fm = Iclnnnnn = @ 
Ready; T=n.nn/n.nn hh:mm:ss 


e EXEC with a corresponding $EXEC: Update 
You will use EXECUPDT to generate the EXEC during the re-building process. | 
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EXEC with no corresponding $EXEC: Replacement 


If you did not receive a new file with the filetype EXEC with your service, and you did receive a file 
with the filetype of EXCnnnnn, where nnnnn is the PTF number, this file must be copied with the 
filetype of EXEC: 


copyfile filename excnnnnn fm = exec = (olddate @ 
Ready; T=n.nn/n.nn hh:mm:ss 


XEDIT with a corresponding $XEDIT: Update 
You will use EXECUPDT to generate the XEDIT macro during the rebuilding process. 
XEDIT with no corresponding $XEDIT: Replacement 


If you did not receive a new file with the filetype XEDIT with your service, and you did receive a file 
with the filetype of XEDnnnnn, where nnnnn is the PTF number, this file must be copied with the 
filetype of XEDIT: 


copyfile filename xednnnnn fim = xedit = (olddate @ 
Ready; T=n.nn/n.nn hh:mm:ss 


MACRO: Update 


You will use VMFMAC to generate a MACLIB with the new MACRO during the rebuilding 
process. 


COPY: Update 


You will use VMFMAC to generate a MACLIB with the new COPY file during the rebuilding 
process. 


Any other types: Replacement 


If the new replacement parts do not already have their appropriate filetype, then they have an 
abbreviated form of the file type concatenated with the PTF number. Use “VM/XA SP Filetypes 
and Abbreviations” on page 863 to find out the complete filetype and copy the file with the complete 
filetype: 


copyfile filename xxxnnnnn fm = ffffffff = (olddate 


Ready; T=n.nn/n.nn hh:am:ss xxx is the abbreviated filetype, nnnnn is the PTF 


number, and ffffffff is the complete filetype. 
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What to Do Next 


e If you do not have a service tape, go to the instructions for rebuilding the component to which you 
applied local service: 


CMS Chapter 14, “Rebuilding CMS after Applying Service” on page 431 

CP Chapter 15, “Rebuilding CP after Applying Service” on page 487 

DV Chapter 16, “Service to DV,” “Step 3. Build the Dump Viewing Facility” on page 512 
GCS Chapter 17, “Service to GCS,” “Step 3. Build a New GCS Macro Library” on page 522 


e If you have a service tape, go to the instructions for receiving service for the component to which you 
applied local service: 


CMS Chapter 10, “Receiving Service for CMS” on page 417 

CP Chapter 11, “Receiving Service for CP” on page 423 

DV Chapter 16, “Service to DV,” “Step 1. Receive Service” on page 508 
GCS Chapter 17, “Service to GCS.” “Step 1. Receive Service” on page 518. 
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Chapter 21. Emergency Local Service Using the Patch Facility 


This chapter describes step-by-step procedures for applying patches to the CMS and CP nuclei. 


introduction 


Before attempting to use the patch facility, read the following sections of this book: 


Chapter 6, “VM/XA System Product Service—An Overview” on page 349 

Chapter 7, “How VM/XA System Product Uses Control Files and Update Files” on page 361 
Chapter 8, “Files Used in PUT and COR Service” on page 371 
“HCPLDR Command” on page 590 in Appendix B, “EXEC and Command Format Summaries” 
“The Patch Facility” on page 616 in Appendix B, “EXEC and Command Format Summaries.” 


The patch facility is used to circumvent problems in text decks on replacement service (object-maintained) 
that are part of the CMS or CP nucleus. If the problem you have is in a file that is not in the nucleus, you 
cannot use the patch facility. 


Patches to object code (TEXT files) exploit the capability of the HCPLDR module when VER, REP, and 
ICS statements are included in the replacement files. 


The instructions in this chapter apply to CMS and CP. Whenever there are variations for different 
components they are noted. 


Your IBM service representative will give you the specific hexadecimal codes that need to be changed. 
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Step 1. Receive the Patch 


In the example below, assume that you have identified the object-maintained part that is causing a problem 
in your VM/XA SP system. You call your IBM service representative, who tells you that there is no existing 
fix for the problem. He tells you that, in order to circumvent the problem, you can change the object code in 
HCPAFF at displacement X'061C' from X'0780' to X'0700'. This example is representative of the type of 
fix you may get. It changes a branch toa no-op. Finally, your representative tells you that he has assigned 
APAR number VM23877 to this problem. If your representative does not give you an APAR number, use a 
local tracking number. 


1. Log on to MAINT and establish the appropriate minidisk accesses: 


vmfsetup 56643089 compid (all @ Substitute for compid the component you are 
Ready; T=n.nn/n.nn hh:mm:ss servicing (CMS or CP). 


2. Create a patch update file on the alternate LOCAL! minidisk: 


xedit hcpaff p23877 b @ Your patch update file may look like Figure 37. 
(npae ee Notes: 
file # 1. Spaces are required between slashes and 


asterisks in the sample patch update file. For 
information on patch update file control 
statement syntax, see the section “The Patch 
Facility” on page 616. 


2. The cards appear as comments in the patch 
update file. The $VMFPAT$ EXEC properly 
inserts the patch update files into the TEXT 
files while running the VMFBLD module. It 
translates the control cards into the format 
required by the VMFBLD module. 
VMFBLD no longer invokes the HCPLDR 
EXEC. 


* PREREQ: NONE 

* CO-REQ: NONE 

NAME HCPAFF 

* This is a patch. It 
* will be replaced by 
* — APAR VM23877. 

VER 61C 0780 

REP 61C 0700 a 


* 
* 
* 
* 
* 
* 
* 
* 


./ 
./ 
./ 
./ 
./ 
| 
/ 
/ 


Figure 37. A Sample Patch Update File 
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Step 2. Apply the Patch 


1. Use XEDIT to create an AUX file entry on the AUXPAT level. 


There are three fields that make up an AUX entry. The first field contains the filetype of the update file. 
Imbedded in this filetype is the 5-digit numeric portion of the APAR number of the fix. When you 
originate an update, this 5-digit number should be a local tracking number. The second field is the level 
of the fix. For patch service you must use TX$ in this field. Since there is no PTF number for the patch, 
the third field is the APAR number or a local tracking number. 


xedit hcpaff auxpat b Your patch AUX file might look like Figure 37 
input on page 556. 
file 


P23877 TX$ VM23877 * A PATCH TO BE REPLACED BY APAR VM23877 


Figure 38. A Sample Patch AUX File 


Note: You would not normally have any service on the AUXLCL level for the part for which you are 
creating a patch, because service on the AUXLCL level is accomplished with source update files. 
If you have the source to update, a patch is not necessary. If, however, you do have service at the 
AUXLCL level, you must rework it so that it does not conflict with the patch you are applying. 
You must also rework any service you have on the AUXPAT level so that it does not conflict 
with the patch you are applying. 


2. Check the control file you are using to make sure that it includes an AUX file identification record for 
the AUXPAT level of service. 


“Main Control Files” on page 364 shows the contents of the default CNTRL files. The default CNTRL 
files for the VM/XA System Product system include the AUXPAT level at the highest level of service. If 
you modify the CNTRL file structure, you must make sure that the AUX file that you create for this 
patch is in your modified structure. 


What to Do Next 


Go to the instructions for rebuilding the component to which you applied the patch: 


CMS Chapter 14, “Rebuilding CMS after Applying Service” on page 431 

CP Chapter 15, “Rebuilding CP after Applying Service” on page 487 

DV Chapter 16, “Service to DV,” “Step 3. Build the Dump Viewing Facility” on page 512 
GCS Chapter 17, “Service to GCS,” “Step 3. Build a New GCS Macro Library” on page 522. 
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Chapter 22. Removing Service from VM/XA SP 


This chapter describes how to remove PUT service, COR service, or local service from any component of 


VM/XA SP. 


If you have a problem with a PTF, or if a PTF arrives for which you have applied a local circumvention, you 
will need to remove service you have applied. 


When you install PUT service, COR service, or local service to VM/XA System Product, you build your new 
system on different minidisks from your old system. You should still have your old system available so you 
Can return to it simply by accessing the old disks. In this way, of course, you remove an entire level of 
service. If you wish to delete only certain PTFs from VM/XA System Product, follow the procedures in this 
chapter. 


First you must understand that many parts of a component, possibly of different kinds, may be serviced by a 
single PTF. You can tell what kind of part an update affects by the part’s filetype: 


The examples in this chapter are written to assist you in understanding what has to be done to remove service 
from VM/XA SP. They are not meant to cover all possible situations. 


1. Make a list of all the PTFs you want to remove, leaving space to write in the corresponding updates. If 
you know the number of the APAR you want to remove, but not the corresponding PTF number, see 
Appendix I, “How to Find the PTF Number from the APAR Number” on page 867. 


In this example, we suppose that you want to remove only one PTF, UM00001, from CP. 


2. With every PTF, you receive a parts list, which identifies all the parts affected by that PTF. Examine the 
parts list: 


vmfsetup 56643089 cp (all 
Ready; T=n.nn/n.nn hh:mm:ss 


xedit um90001 $ptfpart fm @ The filename of the parts list is the PTF number; 
the filemode is $PTFPART. In this example, 
UM00001 is applied from a corrective service tape 
and is therefore on the CP alternate LOCAL] 
disk. If it had been applied from a PUT tape, it 
would be on the CP alternate DELTA disk. 


© Copyright IBM Corp. 1990 559 


HCPABC A34567HP UM00001 $PTFPART lists one update for 
HCPXYZ A34567HP HCPABC and one update for HCPXYZ, along 
HCPABC TXTO0001 with the HCPABC text deck for this PTF. 


. Since a text deck is shipped for HCPABC, it must be an ASSEMBLE file. To find out what kind of part 
HCPXYZ is, check its filetype: 


listfile hcpxyz * * HCPXYZ is a macro. (Replacement macro 
HCPXYZ AUXCOR fim libraries are not shipped on IBM corrective service 
HCPXYZ MACRO fm tapes. Macros are pulled together into a macro 
HCPXYZ MACOQ004 fm library when service is applied with the VMFMAC 
HCPXYZ MACOOO01 fm command.) 


. Comment out or delete the update entries in the auxiliary control file at the service level affected by the 
PTF. (It is better to comment them out, so that you can see what you did.) If the update you are 
commenting out or deleting is not at the top of the auxiliary control file, then you must also comment 
out or delete any updates above the update you are removing. You must also add them to your list of 
updates to be removed if they are not already there. 


xedit hcpabc auxcor Ml Since PTF UM00001 was applied as corrective 
service, it should be listed in the auxiliary control 
file for the corrective service level. If you are 
using the main control file supplied by IBM, the 
filetype of that auxiliary control file is AUXCOR. 


*A88888HP COR UMO0003 The update for PTF UM00001 is listed on the 
*A56789HP COR UMOQD002 third line from the top. 
*A34567HP_COR UMQ0001 


A12345HP COR UMQ000 To comment out an entry, put an asterisk in front 


of it. Remember to comment out the entries above 
the one you want to remove too. 


file @ 


xedit hcpxyz auxcor Hf 
*AQ9999HP COR UMO0004 
*A34567HP COR UMOOO0I 
file @ 


. When you edited HCPABC AUXCOR and HCPXYZ AUXCOR, you found three more updates that 
must be removed. Add these updates, along with the corresponding PTF number in the third word of 
the AUX entry, to your list of fixes to delete. Your list of updates that must be deleted now contains: 


HCPABC A34567HP PTF UMQO0001 
HCPXYZ A34567HP PTF UMQO0001 
HCPABC A88888HP PTF UM00003 
HCPABC A56789HP PTF UMOQ0002 
HCPXYZ A99999HP PTF UM0O0004 


In addition to removing the updates on this list, you must also review the parts lists for the 
corresponding PTFs (UM00003, UM00002, and UM00004) to find all the additional updates in those 
PTFs. You must remove the whole PTF, not just part of it. Save that task for later. For now, just note 
that you will have to look at these additional PTFs after you finish removing the one you set out to 
remove. 
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6. If the PTF you are removing does not affect any text decks, go to Step 7 on page 562. If it does, as in 
this example, determine whether the text deck for which you are removing service is in the load list for 
this component (CPLOAD EXEC, CMSLOAD EXEC, or GCSLOAD EXEC): 


xedit cpload EXEC @ 
locate /hcpabc @ 
qquit @ 


e If the text deck for which you are removing service is in the load list, then, when you apply the next 
PUT tape, the correct text deck, including only the updates that you did not comment out in the 
HCPABC AUXCOR file, is automatically used. Continue with Step 7 on page 562. 


e Ifthe text deck for which you are removing service is not in the load list, you must determine the 
text deck (TXTnnnnn, where nnnnn is the PTF number) that replaces the current HCPABC 
TXTnnnnn (which contains all four fixes, three of which you want to remove). 


a. First list all text decks for the module hit by the updates you want to remove: 


filelist hcpabc txt* * Hf 


HCPABC JTXTQO000 fm 
HCPABC TXT00001 fm 
HCPABC IXTQ0002 fm 
HCPABC TXTQ0003 fm 


b. Next, find the text deck that contains only the updates you want to keep, in this case HCPABC 
A12345HP. It should be the text deck corresponding to the first update you did not comment 
out of the auxiliary control file in Step 4 on page 560 (in this case, HCPABC TXT00000); but, 
to make sure, you can examine the text deck corresponding to the update at the top of the 
auxiliary control file (in this case, HCPABC TXT00003). 


xedit hcpabc txt00003 Hf 


* PREREQ: NONE HCPABC TXT00003 contains the three 
* CO-REQ: NONE updates you want to delete and the one update 
* IF-REQ: NONE you want to keep. 


Al2345HP COR UMOQ0O000 * Comments 
* PREREQ: NONE 

* CO-REQ: NONE 

* IF-REQ: NONE 

A34567HP COR UMO0001 * Comments 
* PREREQ: NONE 

* CO-REQ: NONE 

* IF-REQ: NONE 

A56789HP COR UMOQ002 * Comments 
* PREREQ: NONE 

* CO-REQ: NONE 

* TF-REQ: NONE 

* DEPEND: AQ1010HP 

A88888HP COR UMO0003 * Comments 


(Executable text is here.) 


Find the text deck line that contains the latest update you want to keep. This is the update 
immediately above the first one you want to remove. The third word of that line is the PTF 
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number for this update: UM0O0000. Prefix TXT to the numeric part of this PTF number for the 
filetype of the new text deck: TXT00000. 


c. Since the current text deck for HCPABC contains the fixes you want to delete, you must replace 
it with the text deck that contains only update Al2345HP. Enter: 
copyfile hcpabc txt00006 fm hcpabc text = (replace @ 


Ready; T=n.nn/n.nn hh:mm:ss fm is the filemode of the alternate LOCAL] 
disk. 


7. Next, check each update file that you deleted or commented out of the auxiliary control file for 
DEPEND entries. The DEPEND entries identify previous updates that are dependent on the update you 
are removing. Such updates must also be removed. 


In this example, assume that only HCPABC A&88&88HP contains a DEPEND entry. 


xedit HCPABC A88888HP Ml HCPABC A88888HP contains one DEPEND 


./* PREREQ: NONE entry, for HCPABC AOIOIOHP. (The filename of 
./* CO-REQ: NONE the dependent update file is the same as the 

./* IF-REQ: NONE filename of the update file you are looking at. 

./* DEPEND: AQ1010HP The filetype is listed in the DEPEND entry.) 
qquit # 


8. Add any updates you find in DEPEND entries to your list of updates that you must remove. You know 
the APAR number for these updates (in this example, 01010) from the five numeric characters in the 
filetype; but you do not yet know the corresponding PTF number. (Appendix I, “How to Find the PTF 
Number from the APAR Number” on page 867 will show you how to find it.) For now, put question 
marks in your delete list beside the DEPEND updates and come back to this point later. 


The list of updates to be deleted now looks like this: 


HCPABC A34567HP PIF UMOQ001 
HCPXYZ A34567HP PTF UMOOQ001 
HCPABC A88888HP PTF UMQ0003 
HCPABC A56789HP PTF UMO0002 
HCPXYZ A99999HP PTF UMQ0004 
HCPABC AOQ1O1OHP = PIF ?2????7 


9. Rename the updates you want to remove with a filemode of 1: 


10. 


362 


rename HCPABC A34567HP fm5 = = fml @ 
Ready; T=n.nn/n.nn hh:mm:ss 
rename HCPXYZ A34567HP fm5 = = fml @ 
Ready; T=n.nn/n.nn hh:mm:ss 
rename HCPABC A88888HP fm5 = = fml @ 
Ready; T=n.nn/n.nn hh:mm:ss 
rename HCPABC A56789HP fm5 = = fml 
Ready; T=n.nn/n.nn hh:mm:ss 
rename HCPXYZ A99999HP fm5 = = fml & 


Ready; 
rename 
Ready; 


T=n.nn/n.nn hh:mm:ss 
HCPXYZ AQ1010HP fm5 = 
T=n.nn/n.nn hh:mm:ss 


= fml 


Repeat Steps 2 on page 559 through 9 for each update in your delete list. When you have done this, 
check the parts lists for the PTFs you noted in Step 5 on page 560 and delete any updates included in 
those PTFs that you missed. Then determine the PTF numbers for the DEPEND entries you found in 
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Step 7 (see Appendix I, “How to Find the PTF Number from the APAR Number” on page 867) and 
delete those PTFs. 


11. Finally, rework local service to modules for which you have deleted service. (Local service is service 
listed at any AUX levels above the AUXCOR level in the control file for this component. See 
Chapter 20, “Receiving and Applying Local Service” on page 543.) 


What to Do Next 


¢ If you do not have a service tape, go to the instructions for rebuilding the component from which you 
removed service: 


CMS Chapter 14, “Rebuilding CMS after Applying Service” on page 431 

CP Chapter 15, “Rebuilding CP after Applying Service” on page 487 | 

DV Chapter 16, “Service to DV,” “Step 3. Build the Dump Viewing Facility” on page 512 
GCS Chapter 17, “Service to GCS,” “Step 3. Build a New GCS Macro Library” on page 522 


e If you do have a service tape, go to the instructions for receiving service for the component from which 
you removed service: 


CMS Chapter 10, “Receiving Service for CMS” on page 417 

CP Chapter 11, “Receiving Service for CP” on page 423 

DV Chapter 16, “Service to DV,” “Step 1. Receive Service” on page 508 
GCS Chapter 17, “Service to GCS,” “Step 1. Receive Service” on page 518. 
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Part 3. Appendixes 


This book contains the following appendixes: 


Appendix A, “VM/XA System Product Regeneration Requirements” on page 567, shows the modules 
you must regenerate when you apply a fix. 


Appendix B, “EXEC and Command Format Summaries” on page 575, shows the format and use of 
EXECs and commands you may need for installing and servicing VM/XA System Product. 


Appendix C, “VM/XA System Product Starter System Information” on page 725, gives sample system 
definition files and other information about the VM/XA SP starter system. 


Appendix D, “Listing CP Data Areas and Control Blocks” on page 853, describes a procedure for listing 
VM/XA System Product data areas and control blocks. 


Appendix E, “Example of Alternate GCS Nucleus Placement” on page 855, shows how to save your 
GCS nucleus at a different location than the one in the sample files. 


Appendix F, “Restricted Logon Passwords” on page 859, contains the IBM-supplied list of restricted 
passwords. 


Appendix G, “Controlling Disk String Merges” on page 861, tells you how to prevent the automatic 
merging of a disk string and how to merge disk strings manually. 


Appendix H, “Service Reference Tables” on page 863, lists the standard 3-character abbreviations for 
the various filetypes used in VM/XA SP and the parts supplied for service. 


Appendix I, “How to Find the PTF Number from the APAR Number” on page 867, shows the 
procedure for determining the number of a program temporary fix from the associated APAR number. 


Appendix J, “Messages” on page 869, contains messages issued by the service EXECs. 
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Appendix A. VM/XA System Product Regeneration 
Requirements 


CMS Regeneration Requirements 


Whenever you apply a fix to CMS source code, you must regenerate the CMS nucleus or some CMS 
modules. The following table shows which you must regenerate in each case. (If a source name does not 
appear in the table, either the file is contained within the CMS nucleus, or it is loaded by another file [for 
example, DMSBTB loads DMSBTP].) 


If you must regenerate the CMS nucleus, see Chapter 14, “Rebuilding CMS after Applying Service” on 
page 431. : 


Table 15 (Page 1 of 6). CMS Regeneration Requirements 


Requires Regeneration of 
Change in Source Module/Nucleus EXEC Procedure to Use 
DMSACF Nucleus VMFBLD 
DMSACM Nucleus VMFBLD 
DMSAMS AMSERV CMSGEND 
DMSASD ASSEMBLE CMSGEND 


DMSASM ASSEMBLE CMSGEND 
DMSASN ASSGN CMSGEND 
DMSBAB CMSDOS DOSGEN 


DMSBCT DMSDFT CMSGEND 
DMSBLG DMSDFT CMSGEND 
DMSBOF DMSCUT CMSGEND 
DMSBOP CMSDOS | DOSGEN 


DMSBTB CMSBATCH CMSGEND 
DMSBUS | DMSCUT CMSGEND 
DMSCCM DMSCUT CMSGEND 


DMSCDI DMSDFT CMSGEND 
DMSCCK CATCHECK CMSGEND 
DMSCIA DMSCUT CMSGEND 
DMSCLS CMSDOS DOSGEN 
DMSCMP COMPARE CMSGEND 
DMSCPY Nucleus VMFBLD 
DMSDAS CMSDOS DOSGEN 
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Table 15 (Page 2 of 6). CMS Regeneration Requirements 
Requires Regeneration of 


Change in Source Module/Nucleus EXEC Procedure to Use 
DMSDFT DMSDFT CMSGEND 
DMSDLK DOSLKED CMSGEND 


DMSDMP CMSDOS DOSGEN 
DMSDOS CMSDOS DOSGEN 
DMSDSK DISK CMSGEND 


DMSDSL DOSLIB CMSGEND 
DMSDSV DSERV CMSGEND 
DMSEDC EDIT (see Note 1 on page 572) CMSGEND 
DMSEDF EDIT (see Note 1 on page 572) CMSGEND 


DMSEDI EDIT (see Note 1 on page 572) CMSGEND 
DMSEDX EDIT (see Note 1 on page 572) © CMSGEND 


DMSEND CMSAMS VSAMGEN 
DMSEXG , DCSSGEN CMSGEND 
DMSEXM EXECMAP CMSGEND 
DMSFCH CMSDOS DOSGEN 

DMSFOR FORMAT CMSGEND 
DMSGIO EDIT (see Note 1 on page 572) CMSGEND 


DMSGLB__.. GLOBAL CMSGEND 
DMSGLO Nucleus VMFBLD 
DMSGMF CMSDOS DOSGEN 


DMSGND GENDIRT CMSGEND 

DMSGTM CMSDOS DOSGEN 

DMSGVE CMSDOS DOSGEN 

DMSHLB HELPCONV CMSGEND | 


DMSHLD HELPCONV CMSGEND 
DMSHLI HELPCONV CMSGEND 
DMSHLP HELPCONV CMSGEND 


DMSHLS HELPCONV CMSGEND 
DMSICP IOCP CMSGEND 
DMSIDE Nucleus VMFBLD 
DMSICT DMSCUT CMSGEND 
DMSLAB CMSDOS DOSGEN 
DMSLBD LABELDEF CMSGEND 
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Table 15 (Page 3 of 6). CMS Regeneration Requirements 


Requires Regeneration of 


Change in Source Module/Nucleus EXEC] Procedure to Use 
DMSLBM MACLIB CMSGEND 

DMSLBT TXTLIB CMSGEND 

DMSLCK CMSDOS DOSGEN 


DMSLDF CMSDOS DOSGEN 
DMSLDS LISTDS CMSGEND 


DMSLIC CMSDOS DOSGEN 
DMSLLU LISTIO CMSGEND 
DMSLMX TAPE (see Note 2 on page 572) CMSGEND 
DMSMCM CMSDOS DOSGEN 
DMSMDP MODMAP CMSGEND 
DMSMES[y] DMSMES[y] (see Note 3 on VMFNLS 
page 572) 
DMSMGC GENMSG CMSGEND 
DMSMGE GENMSG CMSGEND 
DMSMVE MOVEFILE CMSGEND 
DMSOPL CMSDOS DOSGEN 
DMSOR! CMSDOS DOSGEN 
DMSOR2 CMSDOS DOSGEN 
DMSOR3 | CMSDOS DOSGEN 


DMSNXD NUCXDROP CMSGEND 
DMSOPT OPTION CMSGEND 
DMSOSR OSRUN CMSGEND 


DMSOVR | SVCTRACE CMSGEND 
DMSOVS DMSOVS CMSGEND 
DMSPIO_ Nucleus VMFBLD 

DMSPBS DMSCUT CMSGEND 
DMSPCA DMSPCC CMSGEND 


DMSPCB DMSPCC CMSGEND 
DMSPCC DMSPCC CMSGEND 


DMSPCR DMSPCC CMSGEND 

DMSPCT DMSPCC CMSGEND 

DMSPCW , DMSPCC CMSGEND 

DMSPOA _ PROPLIB (see Note 4 on CMSGEND 
page 572) 
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Table 15 (Page 4 of 6). CMS Regeneration Requirements 


; Requires Regeneration of 
Change in Source Meodule/Nucleus EXEC Procedure to Use 


DMSPOC PROPLIB (see Note 4 on CMSGEND 
page 572) 

DMSPOD PROPLIB (see Note 4 on CMSGEND 
page 572) 

DMSPOE PROPLIB (see Note 4 on CMSGEND 
page 572) 

DMSPOL : PROPLIB (see Note 4 on CMSGEND 
page 572) 

DMSPON PROPLIB (see Note 4 on CMSGEND 
page 572) 

DMSPOP PROPLIB (see Note 4 on CMSGEND 
page 572) 

DMSPOQ PROPLIB (see Note 4 on CMSGEND 
page 572) 

DMSPOR PROPLIB (see Note 4 on CMSGEND 
page 572) 

DMSPOS PROPLIB (see Note 4 on CMSGEND 
page 572) 

DMSPRE PRELOAD CMSGEND 

DMSPRT Nucleus VMFBLD 


DMSPRV PSERV CMSGEND 
DMSPUN PUNCH CMSGEND 


DMSRDC READCARD CMSGEND 
DMSRDR CMSGEND 
DMSRNE RENUM CMSGEND 
DMSRPG CMSDOS DOSGEN 

DMSRRV RSERV CMSGEND 


DMSRSV RESERVE CMSGEND 
DMSSAP DMSCUT CMSGEND 


DMSSCR EDIT (see Note 1 on page 572) CMSGEND 
DMSSFD SAVEFD — CMSGEND 
DMSSMG DMSDFT CMSGEND 
{ | DMSSNC DMSCUT CMSGEND 
DMSSPA[y] DMSSPA[y] (see Note 3 on VMFNLS 
page 572) 
DMSSPR SETPRT CMSGEND 
DMSSRT SORT - CMSGEND 
DMSSSK. SETKEY CMSGEND 
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Table 15 (Page 5 of 6). CMS Regeneration Requirements 


Requires Regeneration of 


Change in Source Module/Nucleus EXEC Procedure to Use 
DMSSTX CMSDOS | DOSGEN 

DMSSUB CMSDOS DOSGEN 

DMSSUP DMSCUT CMSGEND 

DMSSYN SYNONYM CMSGEND 


DMSSVL CMSDOS DOSGEN 
DMSTMA TAPEMAC CMSGEND 
DMSTPD TAPPDS CMSGEND 


DMSTPE TAPE (see Note 2 on page 572) CMSGEND 
DMSTPF TAPE (see Note 2 on page 572) CMSGEND 
DMSTPG TAPE (see Note 2 on page 572) CMSGEND 
DMSTPH TAPE (see Note 2 on page 572) CMSGEND 


DMSTPI TAPE (see Note 2 on page 572) CMSGEND 
DMSTPJ TAPE (see Note 2 on page 572) CMSGEND 
DMSTRC DMSCUT CMSGEND 


DMSTRT[7] DMSTRTT[)y] (see Note 3 on VMFNLS 
page 572) 


DMSTYP TYPE CMSGEND 
DMSUPD UPDATE CMSGEND 


DMSUSR DMSDFT CMSGEND 
DMSUTL LOADLIB CMSGEND 
DMSVAN CMSAMS VSAMGEN 
DMSVAS CMSAMS VSAMGEN 


DMSVAX CMSAMS VSAMGEN 
DMSVIP CMSVSAM VSAMGEN 
DMSVIS CMSDOS DOSGEN 


DMSVLT CMSDOS DOSGEN 

DMSVVN CMSAMS VSAMGEN 

DMSVVS CMSAMS : VSAMGEN 

DMSXCP CMSDOS DOSGEN 

DMSXMS DMSXMS (see Note 5 on CMSGEND 
page 572) 

DMSXRE DMSXRE (see Note 5 on CMSGEND 
page 572) 

DMSZIT EDIT (see Note 1 on page 572) CMSGEND 
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Table 15 (Page 6 of 6). CMS Regeneration Requirements 


Requires Regeneration of 
Change in Source Module/Nucleus EXEC Procedure to Use 


IOPCxxxx IOCP CMSGEND 

IOPPxxxx IOCP CMSGEND | 
VMFCLEAR VMFCLEAR GENMOD 
VMFDATE VMFDATE CMSGEND 
VMFDOS VMFDOS CMSGEND 
VMFLOAD VMFLOAD CMSGEND 
Notes: 


1. When invoked for EDIT, the CMSGEND EXEC procedure creates the EDIT module and then 
reinvokes itself to create the EDMAIN module. 


. When the CMSGEND EXEC is invoked for TAPE, it creates the TAPE module and then reinvokes 
itself to create the DMSLMX and DMSTPx modules. 


3. y is the country code for your system national language. See Table 5 on page 311. 


4. You receive messages DMSSLK0008W and DMSSOP036E when you regenerate PROPLIB. You 
can ignore them. 


. All EDIT source files, except DMSXMS and DMSXRE, are contained within the CMS nucleus. 
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CP Regeneration Requirements 


If you apply corrective service to certain CP source files, you must also regenerate the corresponding CMS 
modules and stand-alone utilities that can be [PLed. The following table shows the source name, module 
name, and procedures used for regenerating the CMS module. 


The UTILITY EXEC is described in Appendix B, “EXEC and Command Format Summaries” on page 575. 


Table 16. CP Regeneration Requirements 


Requires Regeneration of 
Change in Source Module/Nucleus EXEC Procedures to Use 


HCPBSL 3CARD LOADER UTILITY 


HCPCCF, HCPFAA-H, CPFMTXA UTILITY 
HCPFAL-M, HCPFAR, 
HCPFON 


HCPCCU 


HCPDDC, HCPDDR, 
HCPDDT, HCPDNC, 
HCPDNT 


HCPDIR DIRECTXA UTILITY 
HCPEDx DUMPLOAD UTILITY 
HCPIFC, HCPREA CPEREPXA UTILITY 
HCPIMG GENIMAGE UTILITY 


HCPOPTNS HCPXA, HCPLDRCM VMFMAC 
HCPOVE OVERRIDE UTILITY 
HCPRET RETRIEVE UTILITY 
HCPSADMP HCPSADMP UTILITY 


Note: y is the country code for your system national language. See Table 5 on page 311. 


HCPCCU UTILITY 
UTILITY 
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Dump Viewing Facility Regeneration Requirements 


If you apply corrective service to the dump viewing facility TEXT files, you must also regenerate the dump 
viewing facility. The following table shows the TEXT filename, and the procedure for regenerating the dump 
viewing facility. 


Table 17. Dump Viewing Facility Regeneration Requirements 


$ 


Change in TEXT file Requires Regeneration of Module EXEC Procedures to Use 


HCSxxx ADDMAP, DUMPSCAN, UTILITY 
MAP, PRTDUMP, SCAN, 
TRACERED 


GCS Regeneration Requirements 


If you have local modifications to the GCS message repository, you must regenerate it. The following table 
shows the filename and the procedure to be used for regenerating the dump viewing facility. 


Table 18. GCS Regeneration Requirements 


Change in Source Requires Regeneration of Module EXEC Procedures to Use 
CSIMES[y] CSIMES[}’] VMFNLS 


Note: y is the country code for your system national language. See Table 5 on page 311. 
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Appendix B. EXEC and Command Format Summaries 


This section is a general reference for commands, EXECs, and MODULEs you may use during system 
generation or service application. The commands and EXECs that appear here are: 


ASMGEND EXEC 
CMSGEND EXEC 
DCSSGEN command 
DIRECTXA command 
DISKMAP EXEC 
DOSGEN EXEC 
GROUP EXEC 
HCPLDR command 
INSTFPP EXEC 
ITASK EXEC 

The Patch Facility 
PRELOAD MODULE 
SAMGEN EXEC 
SAMPNSS EXEC 
SPLOAD EXEC 
UPDATE command 
UTILITY EXEC 
VMFAPPLY EXEC 
VMFBLD EXEC 
VMFHASM EXEC 
VMFLKED EXEC 
VMFMAC EXEC 
VMFMERGE EXEC 
VMFNLS EXEC 
VMFOVER EXEC 
VMFPLC EXEC 
VMFPLCD EXEC 
VMFPLC2 command 
VMFREC EXEC 
VMFREMOV EXEC 
VMFSETUP EXEC 
VMFVIEW EXEC 
VMFZAP EXEC 
VSEVSAM EXEC 
ZAP MODULE 
ZAPTEXT EXEC. 
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ASMGEND EXEC 


ASMGEND EXEC 


The ASMGEND EXEC procedure builds the system assembler and creates the associated auxiliary directory. 
ASMGEND loads the text decks for the assembler in the correct overlay structure and produces a load map. 


Format 


The format of the ASMGEND EXEC is: 


ASMGEND 


Usage Notes 


1. The assembler text decks normally reside on the system S-disk in filemode S1. This disk must be 
accessed in some additional filemode before issuing this command in order to locate these files. For 
example: 


access 190 a @ 
access 193 b EH 


2. Use the ASMGEND EXEC if you have modified the assembler IFOXnn MODULE) source. If you 
have not modified this source, and wish to create the assemble module, possibly after modifying 
DMSNGFP or after creating a new CMS system disk, use the CMSGEND EXEC. 


Messages 


ENTER TARGET DISK MODE FOR ASSEMBLE MODULES 
DEFAULTS TO S-DISK IF NONE ENTERED. 


Explanation: Enter the mode letter of the disk containing the assembler modules. The ASSEMBLE 
command accesses this disk during processing. If you enter a mode letter, ASMGEND uses that mode letter 
as the targetmode operand of the GENDIRT command when it creates the auxiliary directory. If you do not 
specify a mode letter, S is used. 


ASSEMBLE XF GEND COMPLETE. 


Explanation: The system assembler and its associated auxiliary directory have been generated successfully. 


ASSEMBLE XF GEND FAILED. 


Explanation: The system assembler text files were not loaded successfully. 
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CMSGEND EXEC 


CMSGEND EXEC 


Use the CMSGEND EXEC procedure to generate a new CMS module or LOADLIB from a text file and 
place the new CMS module or LOADLIB on the specified disk. 


Format 


The format of the CMSGEND EXEC is: 


CMSGEND fn [CTLCMS ha ia 


NOINV 


Where: 


fn | 
is the filename of the CMS module or LOADLIB that is to be generated by the CMSGEND EXEC. 
Only one filename may be specified in the CMSGEND command line. 


The filenames that may be specified in the CMSGEND command are any disk-resident CMS commands 
and service programs. 


CTLCMS 
displays each CMS command as it is executed in the CMSGEND EXEC procedure. This is equivalent to 
the EXEC statement &£CONTROL CMS. 


CTLALL 
displays every executable statement as it is executed in the CMSGEND EXEC procedure. This is 
equivalent to the EXEC statement CONTROL ALL. 


NOCLEAR 
specifies that the CLEAR option is not to be issued when CMSGEND invokes the LOAD command. 


MAP 
specifies that the NOMAP option is not to be issued when CMSGEND invokes the GENMOD 
command. 


NOINV 
issues the NOINV option when CMSGEND invokes the LOAD command; this suppresses the displaying 
of invalid cards at the terminal. If the text deck was created with the VMFASM EXEC, it may contain 
update listing information; these records are displayed during the loading process unless you specify 
NOINV. 


MODE fim 
A 


indicates the access mode of the disk to receive the new module. Filemode A is the default. 
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| 


CMSGEND EXEC 


Usage Notes 


l. 


5. 


The assembler text decks normally reside on the system S-disk in filemode S1. This disk must be 
accessed in some additional filemode before you issue this command in order to locate these files. For 
example: 


access 190 a M (CMS system disk) 
access 293 b MI (CMS DELTA disk) 
access 193 c ME (CMS BASE disk) 


. Use the CMSGEND EXEC if you have not modified the assembler (IFOXmn) source, and wish to create 


the assemble module, possibly after modifying DMSASM, DMSASN, DMSASD, or creating a new CMS 
system disk. 


. You can also use the CMSGEND EXEC to regenerate the ASSEMBLE command when you move the 


CMS system disk. When you specify ASSEMBLE, CMSGEND prompts you to enter a disk mode letter 
so it can refresh the assembler’s auxiliary directory. (Use the ASMGEND EXEC procedure if you are 
updating the assembler.) 


. When using CMSGEND EXEC to regenerate the PROP command, you are only generating the 


PROPLIB LOADLIB. (The CMSGEND options NOCLEAR, MAP, and NOINV have no effect when 
generating the PROP command.) 


The filetype of the text deck must be TEXT. 


How CMSGEND Works 


CMSGEND keeps a list of the CMS disk-resident modules and LOADLIBs, the filenames of the text files 
used to create them, and any special attributes required to generate them. For example, the PRINT 
command must be generated with the ORIGIN TRANS and the SYSTEM options. It is composed of the 


DM 


SPRT text file. To generate a new PRINT module, issue: 


cmsgend print #f 


kkk 


CURRENT STATUS: 


FILE ' PRINT MODULE A2 ' DOES NOT EXIST 
FILE ' PRINT MODULE Al ' DOES NOT EXIST 


kk 


LOADING: 


INVALID CARD - * DMSGPI MACLIB Al 5.6CMS mm/dd/yy hh:mm 


DOMSPRT SO Q0E000 


PRI 


NT Q0E000 


***RESULTS: 
' PRINT MODULE A2 ' CREATED FROM TEXT DECK ( S ) DMSPRT 


WITH OPTIONS TRAMX SYSTEM NOMAP 


R; 
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CMSGEND EXEC 


*** CURRENT STATUS: “fn MODULE An” [EXISTS|DOES NOT EXIST]. 


Explanation: This message indicates whether a generated module already exists. 


wee TINK EDITING: fn TEXT. 

Explanation: This message indicates that CMSGEND is link editing fn TEXT to create a LOADLIB. The 
existing LOADLIB is erased and not renamed when generating a new one. 

«** TOADING: 

Explanation: This message indicates that CMSGEND is loading the text decks. 

*** (UNDEF. NAMES NORMAL FOR EDMAIN) 

*** NOW WE HAVE A SECOND PASS FOR EDMAIN MODULE. 

Explanation: These messages indicate that the EDIT command requires two passes to resolve undefined 
names. 

*** NOW WE HAVE A SECOND PASS FOR DMSTPI MODULE. 


Explanation: This messages indicates that the TAPE command requires two passes to generate the necessary 
modules. The first pass generates the DMSLMX module as the TAPE module; the second pass generates the 
DMSTPE, DMSTPG, DMSTPH, DMSTPI, and DMSTPJ text files as the DMSTPI module. 


*** RESULTS: | 
[‘fn’ MODOLD AY’ WAS ERASED] 
[‘fn MODULE A2’ RENAMED TO ‘fn MODOLD Al”) 


‘fn MODULE A2’ CREATED FROM TEXT DECK(S) ... 
WITH OPTIONS .... 


Explanation: These messages indicate which existing modules were erased and renamed, which text files were 
used to create the new module, and the attributes used to create the module. 


ENTER GENDIRT TARGET DISK MODE LETTER 
( NULL LINE DEFAULTS TO “S” DISK ). 


Explanation: This message is issued when you specify ASSEMBLE. You should enter the mode letter of the 
disk that contains the system assembler. This letter is used as the target disk mode address for the 
GENDIRT command. 


*** ERROR MESSAGE ISSUED IS NORMAL FOR LINK EDITING. 


Explanation: If the TEXT deck was created with VMFASM EXEC, it may contain update listing 
information; these records will cause the linkage editor to generate an error message. The error is normal. 


ERROR OCCURRED. CMSGEND STOPS. 


Explanation: This message indicates that an error occurred and that CMSGEND processing ends. 


INVALID ARGUMENT /n. 


Explanation: This message indicates an invalid filename was specified on the command line. 


TYPE ‘CMSGEND /n < options >’. 


Explanation: This message indicates that no filename was specified on the command line. 
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DCSSGEN Command 


To install CMSINST, use the DCSSGEN command procedure. This command lets you build, load, and save 
a CMSINST segment that contains the EXECs and Editor macros that you select for your installation. 


The installation segment (CMSINST is the default name) is designed to contain EXECs and System Product 
Editor (XEDIT) macros. When a frequently used EXEC or Editor macro resides in a saved segment, 
multiple users can share the same executing copy. 

Before you issue the DCSSGEN command you must create a file that contains a load list of the EXECs and 


System Product Editor CXEDIT) macro instructions to be loaded into the segment. Information about the 
load list follows this description of the DCSSGEN command. 


Format 


The format. of the DCSSGEN command is: 


CMSINST 


DCSSGEN filename filetype filemode  oanast | 


Where: 


filename filetype filemode 
is the file ID of your load list. 


sSegname 

CMSINST 
is the name that you want to assign to the saved segment (segname). The default segment name is 
CMSINST. 


Note: The values for this command are positional. 


DCSSGEN performs the following operations: 


¢ Processes the loadlist file, sequentially loading each EXEC and Editor macro into storage 
¢ Saves the segment 
e¢ Writes a load map to the A-disk as segname DCSSMAP A. 


The Load List for the DCSSGEN Command 

The loadlist must be a fixed-format file with a logical record length of 80. Each record in the file must contain 
the fileid of one EXEC or System Product Editor macro or a comment. DCSSGEN processes the records 
sequentially. 


The format of a DCSSGEN loadilist entry is: 


jn ft [fm [execname [exectype] ] ] 
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Where: 


Jn 
is the filename of the EXEC or editor macro to be loaded. 


is the filetype of the EXEC or editor macro to be loaded. 


fim 
is the filemode of the EXEC or editor macro to be loaded. If the filemode is specified as *, DCSSGEN 
loads the first file in the disk search order that satisfies the filename and filetype qualifications. 


execname 
is the filename to be assigned to the loaded EXEC or editor macro. The default is “=”, which means 
that the present filename is to be used. 


exectype 
is the filetype to be assigned to the loaded EXEC or editor macro. The default is “=”, which means that 
the present filetype ts to be used. 


The filename and filetype of the EXEC or editor macro can each be from 1 to 8 characters. The valid 
characters are A—Z, a—z, 0-9, $, #, @, +, - (hyphen), : (colon), and _ (underscore). The execname and 
exectype may also be from | to 8 characters. However, they are not limited to the filename and filetype 
character set. The only characters NOT valid within an execname and exectype are =, *, ) (right 
parenthesis), ( (left parenthesis), and X'FF'. 


To enter a comment in the loadlist, type an asterisk (*) in column one followed by the text of the comment. 


For example, your loadlist entries may look like this sample: 


* Rename RDRLIST EXEC to MAIL EXEC 
RDRLIST EXEC * MAIL = 

FILELIST EXEC S$ 

SYSPROF EXEC S$ 

PARSE XEDIT S 

DISCARD EXEC $ 

NOTE EXEC $ 

PROFNOTE XEDIT S 

ALL XEDIT $ 


Before you process your loadlist, remove the comments and unnecessary blanks from the source program to 
conserve storage space. The EXECUPDT command with the NOCOMMENTS option removes all 
comments and leading blanks. One comment line containing the exec name and exec type is inserted at the 
beginning of the file. If the source file contains Double-Byte Character Set (DBCS) characters, also specify 
the ETMODE option. For more information about the EXECUPDT command, refer to VM/XA SP CMS 
Command Reference. 


In the load map file, the records copied from your loadlist file are left-justified. The records created during 


the build process are indented five spaces. Comments are also copied from your loadlist file, with an asterisk 
(*) in column one followed by the text. 
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The load map file (CMSINST DCSSMAP A) for the sample loadlist would look like this: 


* RENAME RORLIST EXEC 10 MAIL EXEC 
RDRLIST EXEC * MAIL = 


15:41:59 10/22/85 copy of RDRLIST EXEC S loaded as MAIL EXEC 


EXISBLK - 280000 FBLOCK - 280100 LENGTH - 601C40 
FILELIST EXEC S 

15:41:58 10/22/85 copy of FILELIST EXEC S loaded as 

EXISBLK - 280020 FBLOCK - 281049 LENGTH - 0018(8 
SYSPROF EXEC S 

7:30:18 11/26/85 copy of SYSPROF EXEC S loaded as 

EXISBLK - 280040 FBLOCK - 283608 LENGTH - 002178 
PARSE XEDIT S$ 

8:47:55 12/18/84 copy of PARSE XEDIT S loaded as 

EXISBLK - 280060 BLOCK - 285780 LENGTH - 0024A0 
DISCARD EXEC S$ 

15:40:32 10/22/85 copy of DISCARD EXEC S loaded as 

EXISBLK - 280080 FBLOCK - 287C20 LENGTH - 0012B0 
NOTE EXEC S$ 

11:03:53 10/24/85 copy of NOTE EXEC S loaded as 

EXISBLK - 2800A0  FBLOCK - 288EDO LENGTH - 005310 
PROFNOTE XEDIT S 

15:41:55 10/22/85 copy of PROFNOTE XEDIT S loaded as 

EXISBLK - 2800CO BLOCK - 28E1EQ LENGTH - 060980 
ALL XEDIT S 

15:41:05 10/22/85 copy of ALL XEDIT S$ loaded as 

EXISBLK - 2800EQ FBLOCK - 28EB6Q@ LENGTH - 001298 

*** End of Source List *** 

CMSINST built at 15:56:34 on 12/02/86 
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SYSPROF EXEC 


PARSE XEDIT 


DISCARD EXEC 


NOTE EXEC 


PROFNOTE XEDIT 


ALL XEDIT 
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DIRECTXA Command 


DIRECTXA is a CMS command used to create a CP user directory. 
Note: This command works in a System/370 mode virtual machine only. 
Format 

The format of the DIRECTXA command is: 


USER | DIRECT 


* 


DIRECTXA i [zt il [(options...[)]] 


options: 
[epit] [mrxeo] 


Where: 
jn 
USER 
is the file name of the directory. If not specified, the file name is USER. 
ft 
DIRECT 
is the file type of the directory. If not specified, the file type is DIRECT. 


fin 


is the filemode of the directory. If not specified, the file type is * (the command searches all accessed 
disks for the file name and file type). 


options: 


EDIT 
allows you to issue the DIRECTXA command without updating the directory on disk. With this 
option, you can check the syntax of directory control statements. 


MIXED 
specifies that the DIRECTXA command is to ignore VM/SP statements and options encountered in 
the directory. This allows you to use a directory from a VM/SP system. DIRECTXA prints 
informational messages for each statement or option it ignores. 


How the Directory Program Works 


The DIRECTXA command performs the following steps during execution: 


1, The program looks for the file you specified on the DIRECTXA command line. If you did not specify a 
file name or a file type, the program looks for a file that has the file name of USER and a file type of 
DIRECT. 


2. If the program does not find the directory or an error occurs during processing, the program does not 
create a directory and the old directory remains on line. The program will continue to check the syntax 
of all control statements before ending. 
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3. DIRECTXA looks for the RPWLIST DATA file, which contains a list of restricted passwords. (The 
RPWLIST DATA file supplied by IBM is printed in Appendix F, “Restricted Logon Passwords” on 
page 859. You can edit it to add your own restricted passwords.) If the RPWLIST DATA file is not 
found, DIRECTXA issues a warning message but continues processing. If the RPWLIST DATA file is 
found, DIRECTXA checks all the passwords in the directory against it and changes any restricted 
passwords (except the password of the user issuing the DIRECTXA command) to NOLOG. Any user 
whose password is changed to NOLOG will not be able to log on. If the password of the virtual 
machine issuing the DIRECTXA command is restricted, it is not changed to NOLOG. DIRECTXA 
issues an error message and does not update the directory. 


4. If DIRECTXA runs out of DASD space, the program prints an error message and ends immediately. To 
continue, you must allocate more cylinders for the user directory. 


If DIRECTXA runs out of virtual storage, the command issues an error message and ends immediately. 
To continue, you must define more virtual storage (DEFINE STORAGE command). Using the 
following formula, calculate the size of virtual storage you need: 


vstor = 50 Kb + (16 bytes x userids) 
Where: 


vstor 
is the amount of virtual storage in the program area that DIRECTXA requires. 


userids 
is the total number of users defined in the directory. 


5. If no errors occur, the program writes the directory on DASD and writes the DASD address of the new 
directory on the volume label for that device. If the program is updating an active system directory, the 
program makes the new directory immediately available for the system. 


Usage Notes 


1. A complete description of the directory program, including a description of directory control statements, 
is contained in VM/XA SP Planning and Administration. 


2. When writing a user directory, DIRECTXA does not overwrite the current directory, but does write an 
alternate user directory. The directory pointer in cylinder 0 is then changed to reference this new 
directory. It is advisable, therefore, to issue the DIRECTXA command twice. This assures that the 
directory you wish to use is available; otherwise, you may lose your directory again. 


Restrictions 
1. The DIRECTXA command executes only under CMS. 
2. You must have CP privilege class A, B, or C in order to update the system user directory. 


3. You cannot use the DIRECTXA command to create a directory in VM/XA SP Release 2 format on the 
VM/XA SP Release | system residence volume. You must create the Release 2 directory on a different 
physical pack. 
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Examples 
To compile the USER DIRECT source directory and apply it to the system if successful, enter: 
directxa user direct * @ 


To do a test compile of a USER DIRECT source directory from a VM/SP HPO 5 system, ignoring control 
statements that are valid only for VM/SP or that contain options valid only for VM/SP, enter: 


directxa user direct * (edit mixed @ 


Messages 


VM/XA SYSTEM PRODUCT USER DIRECTORY CREATION PROGRAM - RELEASE 2.0. 


Explanation: You have invoked the directory program. 


EOJ DIRECTORY UPDATED AND ON LINE. 
Explanation: The directory has been updated. The new directory has been placed in use by CP. 


EOJ DIRECTORY UPDATED. 


Explanation: The directory has been updated, but has not been placed in use by CP. You receive this 
response if you write the directory to a CP-formatted DASD that is not a CP-owned volume, or if you do 
not have the necessary privilege class to change the CP directory that is in use. 


EOJ DIRECTORY NOT UPDATED. 


Explanation: The directory has not been updated. You receive this response if you issue the DIRECTXA 
command with the EDIT option. You also receive this response if errors prevent the directory from being 
updated. 


Return Codes 


The DIRECTXA command issues the following return codes: 


Possible Causes 
0 


DIRECTXA executed successfully. The real CP directory has been updated (unless the 
EDIT option was specified). 


The directory source file was not found on an accessed disk. 


An error was encountered while processing the directory source file. 


An invalid option was specified on the DIRECTXA command line. 


4 No errors were encountered, but you do not have the proper privilege class to update the 
real CP directory. 


Condition code | was received from the DIAGNOSE X'3C'. 
A class A, B, or C user updated a virtual directory. 


Condition code 2 was received from the DIAGNOSE X'3C'. 


An invalid directory pointer was found on cylinder 0 record 3. 
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Possible Causes 


7 Condition code 3 was received from the DIAGNOSE X'3C‘'. 
| A fatal I/O error occurred. 


Return codes greater that 100 may be returned and will be accompanied by message 764. 
See the explanation for message 764 for details on these return codes. 
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DISKMAP EXEC 


The DISKMAP EXEC summarizes the MDISK statements in the user directory. The output produced by 
this EXEC shows gaps and overlaps between minidisk assignments. 


Format 


The format of the DISKMAP EXEC is: 


filename fi ad 


DIRECT 


Where: 


filename 
is the filename of the directory to be mapped. 


filetype 
DIRECT 
is the filetype of the directory to be mapped. The default is DIRECT. 


The output from the DISK MAP EXEC is a file sent to your A-disk. The filename of the output is the same 
as that of the target directory. The filetype of the output is DISKMAP. The file contains information on 
MDISK statements found in the directory. The files are in order by volume in the output file. Gaps between 
minidisks and overlapping minidisks are flagged. 


DISKMAP does not replace the EDIT function of the DIRECTXA command. You should use both to 
check your directory after changes. (For a description of the DIRECTXA command, see “DIRECTXA 
Command” on page 583.) | 


Usage Notes 


1. Because some DASD types come in several sizes, DISKMAP does not list gaps found after all minidisks. 
You need to know the maximum cylinder/block value for your DASD type. 


2. DISKMAP creates both the map and a workfile on your A-disk. If your directory is very large and your 
A-disk is almost filled, you may need to find some extra disk space in order to run DISKMAP. 


3. You may choose to include some overlaps in the directory. DISKMAP flags all overlaps; you must 
understand your layout to determine if a particular overlap is expected or in error. 


Example 
To see how DISK MAP works, enter: 
disknap user BB 


This produces a map of the sample directory that you loaded during installation of VM/XA SP. 
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DOSGEN EXEC 


Use the DOSGEN EXEC to create the segment called CMSDOS, which contains text files needed to create a 
CMS/DOS environment that simulates DOS/VSE (Disk Operating System/Virtual Storage Extended) under 
CMS. 


To install CMSDOS, use the DOSGEN EXEC procedure in Step 28 of Chapter 2, “Installing VM/XA 
System Product Release 2.1 with the Starter System (First Level),” Step 28 of Chapter 3, “Installing VM/XA 
System Product Release 2.1 with the Starter System (Second Level),” or Step 30 of Chapter 4, “Installing 
VM/XA System Product Release 2.1 Using an Existing VM/SP or VM/SP HPO System.” You invoke 
DOSGEN with the hex load address and the name that you want to assign to this segment. This load 
address and name must match the address and name that you defined for this segment. 
Notes: 

1. The CMSDOS segment must be defined at a higher address than the CMSBAM segment. 


2. Before you load and save CMSDOS, you must define your virtual machine with at least 512K B free 
storage above the end of the CMSDOS segment. This provides room for the loader tables, which occupy 
the top pages of virtual storage. After you load and save the segment, the loader tables and the 512KB 
free storage are no longer required. 


DOSGEN performs the following operations: 


e Checks that the specified virtual address contains valid characters and that it is greater than X'20000' 
and less than 16MB 


¢ Looks for a read/write accessed A-disk on which to write the CMS loader work file 
e Loads all the text files needed for VSE simulation, starting at the address specified 
¢ Assigns a storage protection key of X'D' 

¢ Saves the segment 

¢ Writes the load map to the A-disk as LOAD MAP AS. 


DMSGENO9SE INVALID ADDRESS. 
Explanation: DOSGEN detected an error in the address that you specified. 


DMSGENO06E NO READ/WRITE A-DISK ACCESSED. 
Explanation: DOSGEN could not find a read/write accessed A-disk. 


DMSGENI11E DOSGEN FAILED DUE TO LOAD ERRORS. 


Explanation: DOSGEN found unresolved external references while loading the text files. 


DMSGEN412S DOSGEN FAILED DUE TO SETKEY ERRORS. 
Explanation: DOSGEN detected an error while assigning the storage key. 


DMSGEN141S DOSGEN FAILED DUE TO SAVESYS ERRORS. 
Explanation: DOSGEN detected an error while saving the segment. 
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GROUP EXEC 


Use the GROUP EXEC to set up a group control system (GCS) configuration file. You can invoke the 
GROUP EXEC from the CMS environment. When you do, you see a series of panels on which you enter 
information about your virtual machine group. 


Format 


The format of the GROUP EXEC is: 


oor | teem 


Where: 


systemname 
is an optional parameter that specifies the filename that you want to assign to the configuration file. If 
you enter this parameter with the GROUP command, then the Primary Option Menu panel appears with 
the SYSTEM NAME field filled in. If you enter the GROUP command without this parameter, then 
you must complete the SYSTEM NAME field on the Primary Option Menu panel. In either case, the 
system name that you specify must match the SYSNAME entry for this GCS system in the DMKSNT 
file. The sample SYSNAME entry is GCS. 


For an example of using the GROUP EXEC panels, see “Step 26. Load, Build, and Save GCS” on page 77. 
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HCPLDR Command 


The HCPLDR command invokes and controls the system loader to perform one of two possible functions: 


e If you issue the HCPLDR command without the PUNCH option or the TAPE option, the loader 
generates a system (directly under CMS); this means the system loader link-edits all object files and 
passes control to the program (HCPGEN) that writes the system on the system residence device. 


¢ If you issue the HCPLDR command with either the TAPE option or the PUNCH option, the loader 
creates a continuous card deck beginning with a three-card loader, continuing with a stand-alone version 
of the system loader, and ending with the object files belonging to the system to be generated. When you 
issue HCPLDR with the TAPE or PUNCH option to generate CP, the loader will not link-edit object 
modules and will not pass control to HCPGEN to write the system on the system residence device. 


Issue the HCPLDR command under CMS. 
Note: This command works in a System/370 mode virtual machine only. 
Format 


The format of the HCPLDR command is: 


HCPLDR loadlist bap | [(options...[ )) 


fti [/|[ ...£t256] 
options: 


[map] [Paces] Kail [NocTL] 


Where: 


loadlist 
is the filename of the load list EXEC file; it contains the names of the object files in the order in which 
they are to be loaded. The load list may look like: 


&CONTROL OFF 

&1 &2 &3 HCPLDR LOADER 
&1 &2 &3 fn [ft] 

&1 &2 &3 fn [ft] 


jn and ft are the filename and filetype of an object file. The ft is optional. If ft is omitted, HCPLDR 
searches the control file or an explicit list of filetypes to determine the filetype. 


HCPLDR LOADER must always be the first file. HCPLDR loads each object module in order from the 
top of the load list to the bottom. 


You can place most loader control statements in the load list EXEC file. You cannot place VERIFY, 
REPLACE, or INCLUDE CONTROL SECTION statements in the EXEC file. A loader control 
statement begins with a 12-2-9 punch (X'02'). Whenever HCPLDR encounters X'02' in the first 
column of a record, it interprets that record as a control statement. For more information see “Loader 
Control Statements” on page 592. | 
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ctifile 
is the filename of the control file. For more information about control files, see “UPDATE Command” 


on page 631. 


HCPLDR uses the update level identifiers in the control file to determine the filetype for those object 
modules listed in the load list without filetypes. The command skips the MACS record in the control file 
and searches for update level identifiers from the top of the control file down. If HCPLDR finds an 
update level identifier other than TEXT, the command appends the identifier to TXT to create a filetype, 
then searches for the file (fn TXTxxxxx). If HCPLDR cannot find an object file that has the first update 
level identifier, the command finds the next identifier and continues the search. As a last resort, when 
HCPLDR cannot find the object file according to update level identifiers, the command searches for /7 
TEXT. For example, if the control file is: 


TEXT MACS HCPM20 HCPM1D 
SPEC AUX1111 
TBM1 AUXR21 


HCPLDR follows this search order: 


fn TXTSPEC 
fn TXTIBM1 
fn TEXT (last resort) 


If an asterisk (*) or a period appears in the first column of a control file record, HCPLDR ignores the 
record. The command also ignores update level identifiers of PTF. 


ftl Uf] [ ...ft256] 
is a list of filetypes (up to 256) that you want HCPLDR to use in lieu of a control file) HCPLDR 


establishes a search order from left to right. The list of filetypes can be null, in which case a filetype 
must be specified for each object module in the load list EXEC. 


If you place a slash (/) anywhere in the filetype list, HCPLDR notifies you when it loads an object 
module that has a filetype to the left of the slash. 


You must use the NOCTL option if you specify filetypes directly on the HCPLDR command line. 
Assume you want to establish the following search order for HCPLDR: 


fn TXT1 
fn TXT2 
fn TXT3 


Also, you want to be notified when HCPLDR uses filetype TXT1 or TXT2. The load list you are using 
is CPLOAD EXEC. Enter the following command: 


hcpldr cpload txtl txt2 / txt3 (noct] s 


When you enter a list of filetypes on the command line, HCPLDR does not look for fn TEXT 
automatically. 


Options: 


MAP 
requests HCPLDR to produce a load map of the system it creates. The load map is called /Joadlist 
MAP Al. 


This option is not valid if you use the TAPE or the PUNCH option. If you use the TAPE or 
PUNCH option, the system loader creates a load map when you load (IPL) the tape or reader. 


PAGEB 
requests that every CSECT be placed on a 4-kilobyte page boundary. 


This option is not valid if you use the TAPE or the PUNCH option. 
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TAPE 
sends the output of object files to a tape drive at virtual device number 0182. At the command 
execution, HCPLDR does not link-edit the system; rather, HCPLDR places a 3-card loader and a 
stand-alone loader before the object modules. When you load (IPL) the tape, the stand-alone loader 
link-edits the object modules and passes control to the program (HCPGEN) that writes the system 
onto the system residence device. The stand-alone loader also creates a load map of the system. 
HCPLDR ignores MAP or PAGEB, if you specify those options along with TAPE. 


PUNCH 
sends a punch file to virtual punch 000D. At the command execution, HCPLDR does not link-edit 
the system; rather, the command places a 3-card loader and a stand-alone loader before the object 
modules. You can spool your punch to your virtual reader or some other (System/370 or 
System/370-XA) virtual machine reader. When loaded (IPL), the stand-alone loader link-edits the 
object modules and passes control to the program (HCPGEN) that writes the system onto the system 
residence device. HCPLDR ignores MAP or PAGEB, if you specify those options along with 
PUNCH. 


NOCTL 
is the option you must use when you use a list of filetypes in lieu of a control file. HCPLDR will 
establish a search order of filetypes according to what you enter on the command line. 


Usage Notes 


1. When you use the system loader as a system generator, your virtual machine must have sufficient storage 
to contain CMS plus the entire system you are generating (in the case of CP, this includes any 
virtual = real region). If the system is too large to generate directly, use the stand-alone version of the 
system loader. 


2. Using the PAGEB option improves the debugging task since it eliminates needless arithmetic (the lower 
three hexadecimal digits of the load address is the same as the assemble address). Note, however, that 
PAGEB should only be used for testing purposes because the option wastes storage. 


3. After the new CP nucleus resides on the system residence device, you can shut down your present system 
(with the SHUTDOWN command) and perform a hardware load of the new system. 


4, The following response may appear when you load the CP nucleus: 


CSECT'S WITH SIZE GREATER THAN CONDITIONAL PAGE 
BOUNDARY @MAPSTRT xxxxxx HCPEMA xxxxxx 


This response is for information only and is no cause for concern unless other CSECTs are listed. The 
response indicates that the CSECTs are larger than the specified page size. HCPEMA contains the error 
message text and @MAPSTRT is the machine-readable load map. CP handles these CSECTs in a 
special way. If any other pageable modules exceed the page size, ensure that you have not added any 
CPB load control statements to the load file and then notify the IBM Support Center. 


Loader Control Statements 
The following describe loader control statements, which can be actual cards or card images. The following 
general rules apply to loader control statements: 

1. The first column of the loader contro! statement must be X'02' (the 12-2-9 punch). 

2. Columns 2—4 must contain the statement acronym. 

3. Unless stated otherwise, operands can appear anywhere between columns 5 and 72. 

4. Unless stated otherwise, operands must consist of arguments of no more than 8 characters. 


5. If a control statement has more than one operand, the operands must be separated by blanks. 
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Printer Control Statement 
The printer control statement enables or disables printing of the cross-reference listings and load maps. 


Format: 


SC 


Where: 
X'02' 
must appear in column one. 


PRT 
is the printer control statement acronym. 


{ON | rdevno } 
enables printing of cross-reference listings and the load map. If you specify ON, the printer is at OOOE. 
If you specify rdevno, the printer is at that device number. 


OFF 
disables printing. 


If you issue the HCPLDR command without the PUNCH or TAPE option, this operand is ignored. 


Note: Only one operand may appear on the statement. 
Set Page Boundary Control Statement 
The set page boundary control statement aligns the next CSECT according to the page size specified. 


Format: 


SN 


Where: 
X'02' 
must appear in column 1. 


SPB 
is the set page boundary control statement acronym. 


nnnnn 
is the page size in hexadecimal. The page size may be any power of 2 from 8 to 65536. If not specified, 
the page size is X'1000' (decimal 4096). 


Note: Only one argument may appear on the statement. 
Unconditional Page Boundary Control Statement 


The unconditional page boundary control statement aligns all subsequent CSECTs according to the page size 
specified. | 
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Format: 


Vee [eeOOOCOOOCSCSCSCSCSCS 
peo [ure [mmm SSS 


X'02' 
must appear in column |. 


is the unconditional page boundary control statement acronym. 


nannn 
is the page size in hexadecimal. The page size may be any power of 2 from 8 to 65536. The initial value 
is 8. If not specified, the page size is X'1000' (decimal 4096). 


Note: Only one argument may appear on the statement. 

Conditional Page Boundary Control Statement 

The conditional page boundary control statement conditionally aligns all subsequent CSECTs according to 
the page size specified. If a CSECT will not fit within the remainder of the present page, the system loader 
will locate the CSECT on the next page boundary. 


Format: 


SO Oe 
co [ore [mm SSS 


X'02' 
must appear in column 1. 


is the conditional page boundary control statement acronym. 


nnnnn 
is the page size in hexadecimal. The page size may be any power of 2 from 8 to 65536. If not specified, 
the page size is X'1000' (decimal 4096). 


Note: Only one argument may appear on the statement. 


Usage Note: The standard value for page sizes is X'1000' (decimal 4096). Module HCPMM64 uses this 
standard size for the CP nucleus. 


Set Location Counter Control Statement 


The set location counter control statement sets the next CSECT at an absolute address. 
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Where: 


X‘02' 
must appear in column 1. 


SLC 
is the set location counter acronym. 


nnnnnnnn 
is the absolute address in hexadecimal. 


Note: Only one argument may appear on the statement. 


Usage Notes: | 
1. Module HCPSYS uses the set location counter control statement to set the size of the virtual= real area. 


2. CMS uses the set location counter control statement to set the transient and user areas. 
Padding Control Statement 


The padding control statement fills all unspecified locations in a CSECT with a specified value. 


Format: 


Where: 


X'02' 
must appear in column 1. 


PAD 
is the padding control statement acronym. 


ni 
is the fill character in hexadecima!. The initial value is 0. 


Note: Only one argument may appear on the statement. 


Usage Note: Padding helps in debugging a program; if a program references unspecified areas, you can 
detect such references by padding with a value of X'FO' or some similar value. 


Parameter Control Statement 


The parameter control statement supplies a parameter string that a loaded system uses upon execution. 


Format: 


cpa [sa OOSOSOSOSOSOSOCSC“‘SCSC“‘“‘SSSSCSCS 
eon | rRM | pamsing CSC~“*‘“~*S*~“*S*SC“~S~S~S~S 


Where: 


X'0@2' 
must appear in column |. 
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PRM 
is the parameter control statement acronym. 


parmstring 
is a parameter string having a 2-byte length field followed by the parameter. When the system begins 
execution, general purpose register one addresses this parameter string. 


Subsystem Control Statement 


The subsystem control statement specifies a subsystem and the location within a virtual machine where the 
subsystem appears. Such a subsystem is a separately loaded system, having its own relocation, page 
boundaries, cross reference listings, and load maps. However, the system loader loads the subsystem as a 
part of the main system. Use such a “system loaded within a system” for stand-alone programs. You can 
load the programs as part of the CP nucleus. 


Format: 


a 
name [loc] 


Where: 
X'02' | 
must appear in column |. 


SYS 
is the subsystem control statement acronym. 


name 
is the name of the subsystem. 


loc 
_ ts the location where the subsystem appears in the virtual machine. If omitted, the location is 0. 


Loader Termination Control Statement 


The loader termination control statement terminates the current system or subsystem. Control is passed to 
the entry point specified on the loader termination control statement. Every subsystem control statement 
must have its corresponding loader termination control statement and there must be one loader termination 
statement for the base system. 


Format: 


Sa 


Where: 


X'02' 
must appear in column 1. 


LDT 
is the loader termination control statement acronym. 
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name 
is the entry point name that receives control after the system nucleus is loaded into real storage. This 
operand is ignored for subsystems. 

Replace Control Statement 


The replace control statement replaces instructions and constants in virtual storage. 


Format: 


a a 


X'02' 
must appear in column 1. 


REP 
is the replace control statement acronym. 


sadd 
is the hexadecimal starting address of the area that will be replaced. 


esdid 
is the External Symbol Identification, a number assigned by the compiler or assembler to the CSECT in 
which the replacement occurs. 


fids 
can be up to eleven 4-digit hexadecimal fields, separated by commas, each replacing one halfword. A 
comma cannot follow the last field. 


nu 
means “not used” by the loader. The field may be left blank or contain program identification. 
Usage Notes: 
1. The replace control statement must be in hexadecimal code. 


2. The data in columns 17—70 (excluding commas) on the replace statement replaces what already was 
loaded into virtual storage beginning at the address specified in columns 7 — 12. 


3. A replace statement may appear: 


¢ Immediately preceding the END statement of an object module, if the module does not contain 
relocatable data (such as address constants) 


e Immediately preceding the first relocatable dictionary statement, if the object module does contain 
relocatable data 


4. If additions made by the replace statements increase the length of a CSECT, an include control section 
control statement must appear preceding the object module. 


5. If the most recent VER control statement for a CSECT failed, the replace operation for that CSECT 
does not occur. 


Verify Control Statement 
The verify control statement verifies a corresponding replace control statement, that is, verify assures that the 


proper data is replaced. 
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Format: 


Es 


Where: 


X'02' 
must appear in column 1. 


VER 
is the verify control statement acronym. 


sadd 
is the hexadecimal starting address of the area to be verified. 


esdid 
is the External Symbol Identification, a number assigned by the compiler or assembler to the CSECT in 
which the verification occurs. 


fds 
is up to eleven 4-digit hexadecimal fields, separated by commas, each verifying previously loaded 
halfwords. A comma cannot follow the last field. 


es 


nu | 
means “not used” by the loader. This field may be blank or contain program identification. 
Usage Notes: 

1. The verify control statement must be in hexadecimal code. 


2. The data in columns 17—70 (excluding commas) on the verify statement verifies what already was loaded 
into virtual storage beginning at the address specified in columns 7 — 12. 


3. Place verify control statements immediately before corresponding replace control statements. 
4. If the verify function fails: 
e The loaded system does not execute. 
¢ All following REP control statements for that CSECT are ignored until the next successful VER 
control statement for that CSECT. 
include Control Section Control Statement 


The include control section statement changes the length of a CSECT. Use it only when replace control 
statements cause a control section to increase in length. 


Format: 


Where: 


X‘02' 
must appear in column 1. 
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ICS 
is the include control section statement acronym. 


name 
is the name of the CSECT you wish to enlarge. 


size 
is the total size required for the CSECT. If size is smaller than the assembled size, the assembled size is 
used. : 


Usage Notes: 
1. Both arguments in the include control section statement are required. 


2. The include control section statement must appear before the first ESD statement of the CSECT. 
Delete Control Statement 
The delete control statement deletes up to eight CSECTs. 


Format: 


DEL name] [... name8] 


Where: 


X'02' 
must appear in column 1. 


DEL 7 
is the delete control section statement acronym. 


namel [...name8] 
is up to eight CSECT names. These names must not be previously defined within the load. Subsequent 
attempts to define these names as part of the system or subsystem will result in those CSECTs being 
deleted. 
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Use the INSTFPP EXEC to install licensed programs. 


Format 


The format of the INSTFPP EXEC is: 


INSTFPP [prodspec! [prodspec2  ...prodspecn]) [(options[)]] 


options: 


Prompt Memo 
 iProapt Noten 


Install] Rewind 
| nOlestal j | nORews nd | 


[alt] [rdev] 


sprodspecl ... prodspecn 
are the product specification codes that let you specify the products you want processed. These codes 
consist of the product number and the feature identification code as listed in the FEATURES 
PRODUCTS file. If no feature identification code exists for a product, specify just the product number. 
If one exists, attach it to the end of the product number. Specify these codes without imbedded hyphens 
or other punctuation. INSTFPP scans the files on the stacked tape and processes the selected licensed 
programs. 


options: 


Prompt 
displays the prompts that ask if you want to process the specified licensed programs. PROMPT is 
the default. 


NOPrompt 
eliminates the prompts that asks if you want to install the specified licensed programs. 


Memo 
prints a product Memo to Users from the tape for each selected product. MEMO is the default. 


NOMemo 
lets you process the selected products without printing product Memo to Users. You cannot specify 
NOMEM6O if you have specified NOINSTALL. 


Install . 
lets you install the selected products. Install is the default. 


NOmInstall 
lets you process the selected products without installing them. You cannot specify NOINSTALL if 
you have specified NOMEMO. 


Rewind 
makes sure the tape is rewound before and after product installation and that it is properly mounted. 
REWIND is the default. 
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NORewind 
lets INSTFPP processing continue without tape rewinds before and after product installation. You 
can specify NOREWIND only if you invoke INSTFPP from the command line. 


Note: Make sure the tape is properly mounted and attached as 181. You can only install products 
located after the initial tape position. 


All 
lets you process all the products on the tape. ALL is the default if you do not enter product 
specification codes. 


rdey 
lets you specify the real tape address if the tape is mounted on a tape drive but not attached to 
MAINT as 181. 


Before Running INSTFPP 


Before you invoke INSTFPP to install licensed programs: 
1. Log on to the MAINT user ID. 
2. Make sure that MAINT has all privilege classes. Enter: 
access 291 c Hf 


xedit user direct 
locate/USER MAINT 


You should see a line similar to this: 


USER MAINT NOLOG 16M 32M ABCDEFG 


The last field in this line defines the privilege classes assigned to MAINT. If your installation uses the 
IBM-supplied privilege classes, you should have classes ABCDEFG. If you do not, type in any classes 
MAINT needs. 


3. While you are still looking at MAINT’s directory entry, check to see if the MAINT 319 minidisk ts 
defined. If it is not, you must define it. 


a. File your directory: 


file 


b. Map your USER DIRECT and examine the map to find a space for the 319 minidisk. Look fora 
gap of appropriate size and record the starting cylinder of that gap. The size you need depends on 
the number of program products you want to install. 


diskmap user direct @ 
File USER DISKMAP A has been created. 
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c. XEDIT your directory and add an entry for the new minidisk: 


xedit user direct H 


locate/USER MAINT @ Locate the MAINT minidisk definitions. 
locate/MDISK @& 


MDISK 319 devtype startcyl cyl label MW ALL MM devtype and label are the device type and label 
of the DASD volume where the new minidisk is 
located. startcyl is the starting cylinder of the 
gap where the new minidisk is defined. cyl is 
the size of the new minidisk in cylinders. 


a Press ENTER to return to the command line. 
file 


If you changed the directory, either to authorize new privilege classes for MAINT or to define the 
MAINT 319 minidisk, issue DIRECTXA to update the directory and bring it online: 


directxa user @ 

VM/XA SYSTEM PRODUCT USER DIRECTORY CREATION PROGRAM - RELEASE 2.0 
HCPDIR750W RESTRICTED PASSWORD FILE NOT FOUND 

EQJ DIRECTORY UPDATED AND ONLINE 

Ready; T=n.nn/n.nn hh:mm:ss 


. Link to the MAINT 319 minidisk in read/wnte mode: 


link * 319 319 w & 


. Format the 319 minidisk if you have just defined it: 


format 319 p (blksize 2048 Hf 

DMSFOR603R FORMAT will erase all the files on disk P(319). 
Do you wish to continue? 
Enter 1 (YES) or © (NO). 

1 

DMSFOR605R Enter disk label: 

mnt319 

DMSFOR733I Formatting disk P 

DMSFOR732I ?? cylinders formatted on P(319) 

Ready; T=n.nn/n.nn hh:mm:ss 


. Access the 319 minidisk as P: 


access 319 p @ 


. Verify that you are linked to the following minidisks: 


MAINT 190 (System disk) 
MAINT 191 (MAINT’s work disk) 
MAINT 193 (CMS BASE) 
MAINT 194 (CP BASE) 
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The INSTFPP EXEC expects these disks to be accessed with these numbers. If your corresponding disks 
have different numbers, redefine and reaccess them. For example, if your system disk is 490 instead of 
190, issue: 


define 490 190 @ 


access 190 fm @ jm is any unused filemode. You cannot access the 
redefined system disk as S. 


. Verify that the INSTFPP code is on one of these disks. Enter: 


listfile instfpp exec * Hf 
INSTFPP EXEC S2 
Ready; T=n.nn/n.nn hh:mm:ss 


. Mount the optional feature product tape. INSTFPP stops if the tape is not mounted correctly. 


. Print a hard copy of your directory: 


print user direct Hf 


Many product installation EXECs link to the user minidisks in write mode. If the link attempt fails, you 
may be asked to enter the write password of the minidisk. 


Verify that you have temporary disk space available on a DASD volume of the same type as your system 
residence volume. You need at least 30 contiguous cylinders of 3380 temporary disk space or an 
equivalent amount of 3350 or 3375 disk space. Enter: 


#cp query alloc 


DASD rdevno volid type TDISK TOTAL=nnnn INUSE=nnnn AVAIL=nnnn 
PAGE TOTAL=nnnn INUSE=nnnn AVAIL=nnnn 
SPOOL TOTAL=nnnn INUSE=nnnn AVAIL=nnnn 
DRCT TOTAL=nnnn INUSE=nnnn AVAIL=nnnn [, ACTIVE] 


The system issues this response for each DASD 
volume attached to the system. ACTIVE indicates 
the DASD volume containing the active directory. 


If necessary, use the CPFMTXA command to allocate more temporary disk space. See VM/XA SP 
CMS Command Reference. 


Enter: 


instfpp (noinstall memo @ 


to print the product Memo to Users for reference and to copy the Memo to Users to the MAINT 319 
minidisk. 

Verify that appropniate spooling control options are in effect to direct the virtual printer spool files 
INSTFPP produces with the PRINT command to the desired real printer. Enter: 


#cp query tag printer # 


PRT vdevno TAG: 
tagtext 
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If you are not satisfied with this setting, change it. You may have to invoke the CP SPOOL command 
or the CP TAG command (or both). 


If your printer handles only uppercase characters, use the FOLD option of the CP LOADBUF 
command. If your printer does not accept the LOADBUF command, print memos by issuing the 
PRINT command with the UPCASE option. In addition, if your printer cannot print special characters 
contained in the product memos printed by INSTFPP, look online at the product Memo to Users on the 
MAINT 319 minidisk. 


Refer to VM/XA SP CP Command Reference and VM/XA SP CMS Command Reference for more 
information about these commands. 


. Set your virtual storage size to 1|6MB unless the product Memo to Users specifies otherwise. 


define storage 16M @ 

STORAGE = 16M 

STORAGE CLEARED - SYSTEM RESET 
ip] cms @ 

VM/XA CMS 5.6 mm/dd/yy hh:m 
i 

Ready; T=n.nn/n.nn hh:mm:ss 


. Mount the product tape on a tape drive and ready the tape drive. 


Warning: Do not attach the tape drive to MAINT. The INSTFPP EXEC will attach it. 


Running INSTFPP 


You can run INSTFPP in panel mode or by specifying products directly. 


If you want to install several licensed programs, or one licensed program for which you do not know the 
product specification code, you will find it easier to run INSTFPP in panel mode. Follow the 
instructions under “Using the INSTFPP Panels.” 


If you want to install only a few licensed programs and know the product specification codes, or if you 
want to install all the licensed programs, you can run INSTFPP either way. If you prefer to specify 
products directly, go to “Specifying Products Directly” on page 608. 


Using the INSTFPP Panels 


l. 
2 


Invoke INSTFPP with no arguments from a 3270 device (20 line minimum). 


When a panel appears on your screen, enter the real tape drive address, change defaults if necessary, and 
press ENTER. 


If you choose not to install all products on the product tape, enter an X next to the products you want to 
install. 


Figures 39 through 45 on pages 605 through 608 show the INSTFPP panels. 
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SOINSO1 INSTFPP INSTALLATION OPTIONS 


If appropriate, change any defaults and then press the ENTER key. 


Real tape address (will be attached as 181): 
Process all products on the tape (Y/N)? Y 
Be prompted before each product is processed (Y/N)? Y 


Alternatives: 
(1) Install the product(s) and print the memo(s) 
(2) Only print the product memo(s) 
(3) Only install the product(s) 
Enter (1, 2, or 3): 


PF1=Help 
PF7= 


ocosc=> 


Figure 39. INSTFPP Panel 1 


Note: If the real tape address appears as R/W, your tape drive is attached to MAINT. Quit and detach the 
tape drive, then reissue INSTFPP. 


SOINSO2 INSTFPP PRODUCT SELECTION PANEL Line 1 of 68 
Type an X next to the product(s) you want to install 
When you have finished, press the PF5 key to begin 


the installation process. 


5668854 
5664289 


ACF/Network Control Program 
ACF/System Support Program 


5664280 
5668899 
5668808 
5767032 
5798RWL 
5664329 
5664296 
5668813 
5668814 
5668918 


PF1=Help 
PF7= 


> 


8=Forward 


ACF/Virtual Telecommunications Access Method 
APL2 

Application Prototype Environment 
Application System 

Composition Utility 

Contextual File Search/370 for VM/CMS 
Cooperative Viewing Facility Version 2 

Cross System Product/Application Development 
Cross System Product/Application Execution 
Cross System Product/Application Query 


4=Return 5=Execute 6= 
9=Sort(prodid) 10=Sort(desc) 11= 12=Cursor 


Figure 40. INSTFPP Panel 2 
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SOINSOZ -INSTFPP PRODUCT SELECTION PANEL Line 13 of 68 


Type an X next to the product(s) you want to install 
When you have finished, press the PF5 key to begin 
the installation process. 


5748XE4 Directory Maintenance 

5748XXB | Display Management System for CMS 
5664370 DisplayWrite/370 

5748XX9 Document Composition Facility 
5735XXB Emulation Program 


5654260 Environmental Recording Editing and Printing Program 
5668890 Font Library Service Facility 

5798DFH FORTRAN Utilities 

5668801 Graphical Data Display Manager - IMD 

5668812 Graphical Data Display Manager - PGF 

5668812 Graphical Data Display Manager - PGF NL Feature 
5664200 Graphical Data Display Manager Base 


PFi=Help 4=Return 5=Execute 6= 
PF7=Backward 8=Forward =Sort(prodid) 10=Sort(desc) 11= 12=Cursor 


Figure 41. INSTFPP Panel 3 


SOINSO2 INSTFPP PRODUCT SELECTION PANEL Line 25 of 68 


Type an X next to the product(s) you want to install 
When you have finished, press the PF5 key to begin 
the installation process. 


5664200 NL Graphical Data Display Manager Base NL Feature 
5668905 Graphical Display And Query Facility 

5799AXX Graphics Attachment Support Programming 
5799BKE Host Displaywriter Document Interchange 
5668996 IBM BASIC/VM 


5664185 IBM High-Accuracy Arithmetic Subroutine Library 
5798DTE 18M 3812 Pageprinter VM Support 

5668897 Info Center/1 

5668012 Interactive Instructional Presentation System 
5664282 Interactive System Productivity Facility 
5664285 Interactive System Productivity Facility/PDF 
5664204 NetView Volume 1 


PFl=Help =Quit 4=Return 5=Execute 6= 
PF7=Backward 8=Forward 9=Sort(prodid) 10=Sort(desc) 11= 12=Cursor 


mene e' 
ats CS 


Figure 42. INSTFPP Panel 4 
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SOINSOZ INSTFPP PRODUCT SELECTION PANEL Line 37 of 68 


Type an X next to the product(s) you want to install 
When you have finished, 
the installation process. 


press the PF5 key to begin 


5664204 3=s_ 02 
5664204 8 Q3 
5734PL3 
5734LM5 
5664293 
5664199 
5796PNQ 
5664298 
5664312 
5664198 
5664198 
5664198 


NetView Volume 2 

NetView Volume 3 

OS PL/1 Optimizing Compiler and Libraries 
OS PL/1 Transient Library 
Overlay Generation Language 
Page Printer Formatting Aid 
Pascal /VS 

PC Bond 

Print Services Access Facility 
Print Services Facility/VM Base 
Print Services Facility/VM 3800 
Print Services Facility/VM 3820 


PF1=Help 2= 
PF7=Backward 8=Forward 


4=Return 5=Execute 


9=Sort(prodid) 10=Sort(desc) 11= 12=Cursor 


> 


Figure 43. INSTFPP Panel 5 


SOINSO2Z INSTFPP PRODUCT SELECTION PANEL Line 49 of 68 
Type an X next to the product(s) you want to install 
When you have finished, press the PF5 key to begin 


the installation process. 


5664309 
5664309 PA 


Professional Office System 
Professional Office System Applications Support Feature 


5668AAA 
5748XP1 
5664188 
5748XXJ 
§664191 
5664319 
5746AM2 
5664318 
5664364 
5798DMY 


Query Management Facility 

RSCS Networking, Version 1 

RSCS Networking, Version 2 

Structured Query Language/Data System 

Virtual Machine Monitor Analysis Program 

Virtual Machine/Personal Computer Host Server 

Virtual Storage Extended/Virtual Storage Access Method 
VM/Interactive Productivity Facility 

VM Batch Facility 

VM File Storage Facility 


4=Return 5=Execute 6= 
9=Sort(prodid) 10=Sort(desc) 11= 12=Cursor 


PF1=Help 2= 
PF7=Backward 8=Forward 


osc > 


Figure 44. INSTFPP Panel 6 
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SOINSO2 INSTFPP PRODUCT SELECTION PANEL Line 61 of 68 


Type an X next to the product(s) you want to install 
When you have finished, press the PF5 key to begin 
the installation process. 


5748RC1 VM/Pass-through Facility 

5796PNA VM Real Time Monitor 

5664283 VM/Integrated System-Productivity Facility 
5664291 VMBACKUP Management System 

5664292 VMTAPE Management System 

5668958 VS COBOL II 

5668806 VS FORTRAN 

5664281 3270 PC File Transfer 


PF1=Help 2= 4=Return 5=Execute  6= 
PF7=Backward 8= 9-Sort(prodid) 10=Sort(desc) 11= 12=Cursor 


eSscs> 


Figure 45. INSTFPP Panel 7 
Specifying Products Directly 


If you enter arguments, the INSTFPP panels do not appear on your screen. You can specify product 
specification codes by listing them as you find them in the FEATURE$ PRODUCTS file. Omit hyphens or 
other punctuation marks, and leave one blank between each code. You can specify up to 130 characters, 
including the command and options, on the CMS command line. 


To install all the licensed programs available, specify the ALL option. 


After Running INSTFPP 


After you run INSTFPP, do the following steps: 


1. Execute manual installation and verification procedures as indicated in the product Memo to Users if 
necessary. 


2. Tailor product-dependent files as indicated in the product Memo to Users if necessary. 


3. Resave CMS if licensed programs that you installed loaded files to the MAINT 19E minidisk (the 
Y-disk). 


4. Consider placing file directory information for shared, read/only minidisks into a DCSS using the 
SAVEFD command. Refer to VM/XA SP CMS Command Reference. 
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Notes: 


1. INSTFPP cannot properly restore minidisks accessed as read/only extensions with a subset defined. 
INSTFPP reaccesses minidisks as read/only extensions with no subset specification. 


2. INSTFPP leaves the tape drive containing the optional feature product tape attached as virtual address 
181. 


3. A console file is created during the installation process to record terminal activity and is spooled to the 
MAINT reader when INSTFPP is complete. 


PROD LEVEL File 


INSTFPP updates a PROD LEVEL file on the MAINT 319 minidisk with the results of each licensed 
program installation. 


Example 


Figure 46 shows an example of a PROD LEVEL file. 


5748XXB Display Management System (DMS/CMS) 
VER 1 REL 2 MOD 0 

Time and date of entry: 20:25:25 30 Sep 1986 
*** Product installed and verified successfully 


5799AXX 3277 Graphics Attachment Support PRPQ (GASP) 
VER 1 REL 3 MOD 0 

Time and date of entry: 21:17:25 30 Sep 1986 

*** Product installed; manual verification required 


Figure 46. Sample PROD LEVEL File 


Each licensed program entry in the PROD LEVEL file has an update message associated with it. The 
possible update messages and their explanations are: 


*** Product installed and verified successfully 


Explanation: The licensed program was installed correctly, and the product was verified successfully. 


*** Product files loaded; see the Memo to Users to complete installation 


Explanation: The licensed program files have been loaded successfully. Refer to the product Memo to Users 
printed by INSTFPP. This memo tells you how to complete the installation of the product and then verify 
that it installed correctly. In some cases, the product Memo to Users refers to other documentation. 


*** Product installed; manual verification required 


Explanation: The licensed program was installed, but it was not verified automatically. Refer to the product 
Memo to Users printed by INSTFPP. This memo tells you how to make sure the licensed program installed 
correctly. In some cases, the product Memo to Users refers to other documentation. 
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*** Product installed; verification failed 


Explanation: The licensed program was installed, but the automatic verification failed. Try to install the 
licensed program again after correcting any problems; if it does not verify correctly, contact your support 
personnel. 

*** Product Installation EXEC failed; RC = rc 


Explanation: The product installation EXEC failed, and the return code passed back by this EXEC to 
INSTFPP is rc. Refer to the product Memo to Users or product installation EXEC prolog to see what this 
return code means. If you cannot fix the problem, contact your support personnel. 


Rerunning INSTFPP 


If any licensed programs do not install correctly, take the following steps: 


1. Try to solve the problem by using the console log, product Memo to Users, the PROD LEVEL file, and 
other product-specific documentation. 


2. Ready the tape. 
3. Invoke INSTFPP. 
4. Reinstall products that did not install correctly, plus any products that have these products as 


prerequisites. 


After you install each licensed program, follow the instructions in the product Memo to Users to verify that it 
has installed correctly (unless it was automatically verified during installation.) 
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ITASK EXEC 


ITASK EXEC is a tool used primarily in the Starter System installation procedure. It invokes other EXECs 
and commands to perform installation and system generation tasks, to let you complete the installation 
process with fewer entries and decisions. 


Format 


The format of the ITASK. EXEC is: 


DUMPVIEW 
GCS 

HELP 
AMENGHLP 
UCENGHLP 
CPSRC 
CMSSRC 
DVSRC 


LANG 


CMSSRC 


[NOASSEM] 


systemname 
GCS 


ASSEMBLE 
HCPSYS 


ALLOCATE 
BASEIDS 
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Where: 


LOAD 
invokes SPLOAD EXEC to load files from the product tapes, to the minidisks specified in SPLOAD 
PROFILE. Some LOAD operands may perform additional operations. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


ALLI 
loads all the CP and dump viewing facility OBJECT, DELTA, and APPLY files from Volume 1 of 
the product tape. 


ALL3 
loads all the CP, CMS, and dump viewing facility source files from Volume 3 of the product tape. 


CP 
checks to ensure that the SYSGEN tools are loaded, and then loads the the CP object code, DELTA, 
and APPLY files from the product tape. 


CMS 
checks to ensure that the SYSGEN tools are loaded, and then loads the IOCP files, CMS SYSTEM, 
CMS DELTA, CMS APPLY, and CMS BASE tape files from the product tape; then invokes the 
ASMGEND EXEC to build the starter system assembler. 


DUMPVIEW 
loads the dump viewing facility object, DELTA, and APPLY files from the product tape. 


GCS 
loads the GCS INTERFACE and GCS OBJECT tape files from the product tape. 


HELP 
loads the HELP FILES tape file from the product tape. First the mixed-case American English 
HELP files are loaded to the 19D disk; then they are copied to the 19C disk and converted to 
uppercase. 


AMENGHLP 
loads the mixed-case American English HELP files to the 19D disk. 


UCENGHLP 
loads the mixed-case American English HELP files directly to the 19C disk, then converts them to 
uppercase. 


CPSRC 
loads the CP SOURCE tape file from the product tape. 


CMSSRC 
loads the CMS SOURCE tape file from the product tape. 


DVSRC 
loads the DUMPVIEW SOURCE tape file from the product tape. 


LANG 
indicates that national language files are to be loaded from a national language feature tape. 


ALL 
loads the entire contents of the national language feature tape. 


ALLOBJ 
loads only the object (non-source) code. This consists of the following tape files: CP OBJECT, CMS 
BASE, and GCS OBJECT. 


612 Installation and Service 


ITASK EXEC 


CP 
loads only the CP OBJECT tape files. 


CMS 
loads only the CMS BASE tape files. 


GCS 
loads only the GCS OBJECT tape files. 


HELP 
loads only the HELP FILES tape file. 


CMSSRC 
loads only the CMS SOURCE tape file. 


BUILD 
invokes VMFBLD EXEC to build the specified nucleus. 


CP 
assembles the CP sample files; invokes the VMFBLD EXEC to build the CP nucleus. 


If the NOASSEM option is used, the CP sample files are not assembled. This option assumes that 
these files are already assembled individually. 


CMS 
invokes the VMFBLD EXEC to build the CMS nucleus. 


GCS 
modifies a copy of the GCS loadlist (GCSLOAD EXEC) and changes the default configuration file 
entry (GCS) to match the filename of the GCS configuration file, systemname GROUP (if you do not 
specify a filename, the default is GCS); renames the filetype of the configuration file from GROUP 
to ASSEMBLE; assembles the configuration file; and invokes the VMFBLD EXEC procedure to 
build and save the GCS nucleus. 


ASSEMBLE 
assembles the specified sample file: 


ALL 
assembles the HCPBOX, HCPRIO, and HCPSYS files (but not the DMSNGP file). 


DMSNGP 
assembles only the DMSNGP file. 


HCPBOX 
assembles only the HCPBOX file. 


HCPRIO 
assembles only the HCPRIO file. 


HCPSYS 
assembles only the HCPSYS file. 


ALLOCATE 
loads in sample directory from the product tape, prompts for a new password to be used by both 
MAINT and Operator, replaces the starter system directory with this sample directory, and then loads 
the following files from Volume | of the product tape. 


File Contents 
SYSGEN TOOLS S$DASD$ CONSTS, DISKMAP EXEC 
SYSTEM SAMPLES DVM PROFILE, SAMPNSS EXEC, starter IOCP, FILECONV 


SAMPEXEC, CONVSYS SAMPCMDS, CONVUCR SAMPCMDS, 
COMPSCAN SAMPEXEC, COMPSCAN SAMPLIST, VMFUECP 
EXEC, VMFUECMS EXEC, VMFUEDV EXEC 
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File Contents 

CPLOC SAMPLES HCPBOX ASSEMBLE, HCPRIOXA ASSEMBLE, 332n DIRECT, 33nn 
DISKMAP, HCPSYSnn ASSEMBLE 

CMSLOC SAMPLES DMSNGP ASSEMBLE, DMSNGP TEXT, DMSNGP TXTUCENG 

After loading the files, the ITASK. EXEC renames the following files: 

Preload Name Name After Load 

33nmn DIRECT USER DIRECT 

33nn DISKMAP USER DISKMAP 


HCPSYSxx ASSEMBLE HCPSYS ASSEMBLE 
The placement of these files is determined by the SPLOAD PROFILE. 


The ITASK EXEC also allocates space on the DASD volumes identified in the $ALLOCS user ID in the 
CP directory. 


You are prompted for the real address of each DASD volume, and you have the option to SKIP any 
volume that you do not want to allocate. Allocation is done according to the entries in the directory; all 
space not specifically allocated is allocated as PERM. 


BASEIDS 
issues the CMS FORMAT command to format the remaining minidisks defined in the base CP directory 
which did not have code loaded to them during the installation process. 


The minidisks formatted during this procedure are: 
e AUTOLOG 191 

e CMSBATCH 195 

¢ DISKACNT 191 

e EREP 191 


¢ MAINT or XAMAINT 192, 194, 19C, 19D, 19E, 201, 291, 293, 294, 36E (PVM), 391, 392, 393, 394, 
423, 490, 491, 492, 495, 49C, 49D, 501, 591, 592, 593, 594, 595, 596, 59E, 691, 692, 791, 892, 895, 
896, 89E 


Note: If you issue ITASK BASEIDS from a user ID other than MAINT or XAMAINT, that user 
ID’s minidisks are formatted instead. 


¢ OPERATNS 191 
e RSCS 191. 


Also, a PROFILE EXEC is placed on the EREP 191 and DISKACNT 191 minidisks during this 
procedure. 


Messages and Return Codes 


DMSWTK002E File fn ft [fm] not found [RC =28] 
DMSWTK003E Invalid option: option [RC =24] 
DMSWTKO08E ___ Device vdev invalid or nonexistent [RC = 36] 
DMSWTKOSOE Parameter missing after function [RC =24] 
DMSWTKO70E _siInvalid parameter parameter [RC = 24] 
DMSWTK095E Invalid address vstor [RC = 100] 
DMSWTK360E Invalid response response [RC =0] 
DMSWTK961E There are class class files in the device 
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DMSWTK965I 


DMSWTK969I 


DMSWTK9701 

DMSWTK981R 
DMSWTK982R 
DMSWTK983E 
DMSWTK13101 


DMSWTKS8605R 


ITASK EXEC 


You may wish to tailor the following files before nuclei generation: 


HCPBOX ASSEMBLE 


HCPRIO ASSEMBLE 
HCPSYS ASSEMBLE 


DMSNGP ASSEMBLE 


USER DIRECT 
[RC =20] 


Do you wish to have the HELP files converted to uppercase? [RC =0] 


Type: (Yes) or No [RC =0] 
The following minidisks defined in the base CP directory will be formatted: 


userid 192 userid 49C 
userid 194 userid 49D 
userid 19C userid 501 
userid 19D userid 591 
userid 19E userid 592 
userid 201 userid 593 
userid 291 userid 594 
userid 293 userid 595 
userid 294 userid 596 
userid 391 userid 59E 
userid 392 userid 691 
userid 393 userid 692 
userid 394 userid 791 
userid 423 userid 892 
userid 490 userid 895 
userid 491 userid 896 
userid 492 userid 89E 
userid 495 

[RC =0] 

A PROFILE EXEC has successfully been copied to {EREP’s|DISKACNT’s} 191 minidisk. 
[RC=0] 


Formatting user id vdevno minidisk [RC =0] 

What is the real address of your volume volume? [RC =0] 

Type: Real address or SKIP [RC =0] 

Violation of CMS naming convention found in args [RC =24] 

Do you want to format minidisks: AUTOLOGI 191, CMSBATCH 195, DISKACNT 191, 
userid 36E (PVM), EPEP 191, OPERATNS 191, and RSCS 191? [RC=0] 


Type: 1 (Yes) or 0 (No). 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 


Appendix B. EXEC and Command Format Summaries 615 


Patch Facility 


The Patch Facility 


The patch facility is used to make changes to TEXT files in the CP or CMS nucleus. 


The patch facility lets you maintain (patch) object code when neither source nor object deck replacements are 
available. These patches are a temporary solution to object code problems until you receive a replacement 
file from IBM. 


The procedure for maintaining object code is similar to that for maintaining source code. However, with 
object code, rather than changing source and reassembling the source file, you will apply changes directly to 
the TEXT files as the nucleus is generated. 


Controlling Patches 


You control patches with three kinds of files: 


¢ Control files 
e AUXiliary files 
¢ Update files. 


Note: As with source updates to base ASSEMBLE files, patches to TEXT files do not cause any changes to 
the original TEXT files because temporary TEXT files are created. The temporary TEXT files are 
used to generate the nucleus, then erased. 


The following is a description of the files and elements you will need to understand to make object code 
patches: 


Control File This file contains a MACLIB statement and a list of filetypes, one for each level of AUX 
file. It also contains the text deck qualifier for each level. A keyword, TX$, must follow 
the last AUX filename on a line to flag the AUX file or update as containing text patches. 


Note: The patch facility creates a temporary control file with a filename of $SSTUPS$S 
CNTRL. The use of this name for any control file is restricted to the patch facility. 


AUX File This file contains a list of the filetypes of update files. The update files contain source 
updates to source or updates to TEXT files. 


Note: Any entry in the AUX file which contains the name of a patch update file must 
contain the TX$ control word between columns 8 and 13. 


Load Map This function contains information from both the map of CSECT external symbol 
resolution and service level information. The map also includes local patches and 
co-requisite and prerequisite information. The date and time listed in the load map for each 
patched text file are the original date and time, not the date and time when the temporary 
deck was created. 


TEXT File This file contains the data elements that have been assembled by the customer for source 
i maintenance or provided (already assembled) by IBM for object maintenance. You use it to 
create executable modules. These files contain APAR corequisite and prerequisite 
information. 


Note: The patch facility creates temporary text files with a filetype of TXT$TUP$. Only 
the HCPLDR EXEC (the loader EXEC) may use this filetype. 
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Example of a Patch Update File 


The following are the functionally equivalent HCPLDR EXEC control statements contained in the update 
file, which will appear as comments to the update program: 


./ * * CO-REQ: nnnnnnan 
./ * * PREREQ: nnannnnnn 
-/ * NAME CSECTname 

./ k % 

./ * VER disp data 

./ * REP disp data 

./ * ICS name size 


These statements are equivalent to the loader control statements in content. HCPLDR EXEC reformats the 
statements to make them acceptable to HCPLDR module. 


Note: Pre-allocated patch areas are not required because the loader can expand any CSECT in the 
executable module as it is created from the text files. Addressability to the expanded area is available 
in every CSECT although space for a patch area need not be. This results in reduced size of 
executable modules because patch areas do not consume space until they are used. 


The following is an explanation of each statement: 
Note: Each statement below must be preceded by “./” . 


* NAME CSECTname 
This statement identifies which CSECT in a text file is to be patched. It is optional. The 
CSECTname must match the SD name from the ESD for the module. If you omit this statement, 
the CSECT with the same name as the filename is patched. 


* * comment 
This is a comment to the loader EXEC and is optional. 


* * CO-REQ: nnnnnnnn 
This is an APAR requisite comment. Use it to indicate dependencies on APARs or other patches. 
The following format is suggested: 


./ * * CO-REQ: V¥M23418 
./ * * PREREQ: VM23418 


When there are no dependencies, enter NONE after the keywords CO-REQ: and PREREQ:. 


* VER disp data 
This statement verifies that the patch is applied at the correct point in the executable module. 
You need at least one verify statement for each patch. As much data as is required to assure 
uniqueness should be verified. For example, you may include a verify of the date in the copyright 
constant of the module prologue. 


The disp is the displacement, in hex, of the location to be patched in the CSECT. 


The data is the existing old data in hex to be replaced. This may be up to eleven 4-digit fields — 
separated by commas. A comma may not follow the last halfword. 


* REP disp data 
This statement contains the data to replaced in the CSECT. 


The disp contains the displacement in hex of the location to be patched in the CSECT. 


The data is the new data in hex that will replace the existing data. This may be up to eleven 
4-digit fields separated by commas. A comma may not follow the last halfword. 
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* ICS name size 


This statement expands the CSECT in the executable module (nucleus). This statement is 
optional. 


The name is the same name used in the NAME statement. If a NAME statement is not present, 
name must match the filename of the patch file in which it is included. 


The size is the total size required for the CSECT. 


The following are the functions used in the object service process: 
¢ VMFBLD EXEC 
The VMFBLD EXEC invokes the loader EXEC (that is, HCPLDR EXEC). 
¢ HCPLDR EXEC 
This EXEC exploits the Verify and Replace capabilities of the loader module. 
It gathers TEXT files into an executable nucleus based upon control information. 


Note: This function does not change previous HCPLDR command syntax except to include a 
NOPATCH option. 


This EXEC provides the same level of control for local service, when source is not available, as is 
currently provided for source file updates. This means that the nucleus-generation process automatically 
locates and tries to reapply a local patch each time a replacement update file arrives from IBM. 


This results in one of two possibilities: 
1. The local fix is applied and you receive replacement update files. You must then evaluate whether: 
— The local fix is obsolete. 


If the replacement update file contains the APAR fix that replaces the local fix, then you can 
remove the local fix by removing the object update from the AUX file or the control file. 


— The local fix is still needed. 


If the replacement update file does not contain an APAR fix that replaces the local fix, then you 
will leave the local fix in place. 


2. The local fix is not applied and you receive replacement service files. You must then evaluate 
whether: 


— The local fix is obsolete. 


If the replacement update file contains an APAR fix that replaces the local fix, you just accept 
the replacement deck. 


— The replacement update file does not contain an APAR fix equivalent to the local fix. 
If the replacement update file does not contain an APAR fix that replaces the local fix, you may: 
— Choose the APAR fix as more important, and just accept the replacement update file. 


— Fix both problems by accepting the replacement update file and reworking the local fix. 


Compatibility with HCPLDR 


A temporary composite TEXT file is created by the loader EXEC; the composite TEXT file is a copy of the 
IBM-supplied TEXT file with the patch update file merged into it. The temporary text deck will have the 
same date and time as the original. The NAME statement is not included in a composite TEXT file. The 
NAME statement is used only to identify the correct CSECT. When this statement is not present, the patch 
update file changes the CSECT with the same name as the TEXT file. 
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A composite TEXT file may include: 


e The patch AUX file entry Gincluded as a comment), placed following existing comments, but before the 
first ESD statement. 

¢ An APAR requisite comment, placed after the AUX file comment, but before the first ESD statement. 

e An optional ICS statement, placed after an APAR requisite statement, but before the first ESD 
statement. 

e Required VER and REP statements, placed after any ICS statement, but before the first RLD statement 
or before the END statement if there is no RLD statement in the TEXT deck. 

¢ Patch update file comments, included as they are encountered. 


For each NAME statement in a patch update file and for each patch update file without a NAME statement, 
a VERIFY statement must be present or the patch is not accepted by the loader EXEC. The composite 
TEXT file will have the same filename and its filetype will be TXTSTUPS. 


The loader EXEC works the same way as the current HCPLDR command works. The EXEC goes through 
the load list one module at a time, using the CNTRL file to determine the filetype. For each temporary 
composite TEXT file, the EXEC provides a filename with the filetype TXTSTUP$. In addition, the EXEC 
creates a $SSTUPS$$ CNTRL file that contains the filetype qualifier (STUPS that produces a filetype of 
TXTS$TUP$S) of the composite TEXT file created by the loader EXEC. 


The loader EXEC invokes the HCPLDR MODULE by passing it a temporary control file named $$$TUPSS 
along with other parameters. All temporary files such as TXTSTUP$ or $$STUP$$ have a filemode of 3; 
these files are erased automatically as soon as they are used. 


Usage Notes 


The patch facility is provided to give you: 
e The same control that you have with source updates and IBM update file updates. 


e The same tracking capability so that no previously applied patch will be lost or ignored when IBM 
replacement service is applied based upon the contents of the load map. 


The following guidelines are recommendations to follow: 
1. Keep each fix to a TEXT file in a separate update file. 
This also applies to source update fixes; each source update fix should be in a separate update file. 
Each fix should have an alphanumeric number that is the filetype of the update file. 


2. Keep all local fix descriptions for the same TEXT file in the same AUX file, unless a fix applies to a 
different control file level. 


Local fixes for the same TEXT file should not be distributed over AUX files (different control file levels) 
arbitrarily. Local service should be easily distinguished from IBM service and should always be applied 
last. Local service can be distributed over separate control files for the purpose of maintaining different 
service levels with a single structure of AUX and update files. Each level can be built from a different 
control file containing only the desired level identifiers. 


3. Never place local patches in AUX files from IBM. In other words, keep your local service separate from 
IBM service. Local service should be easily distinguished from IBM service and should always be applied 
last. 


4. Patches to TEXT files should be applied only when no source file is available. Mixing source updates 
and TEXT file patches for the same module will lead to confusion and is not recommended. 
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Example of Local Service to TEXT Files 


The following is an example of a control structure containing patches at more than one level. This is an 
appropriate use of the patch facility. 


PRODSYS CNTRL L3 AUXLCL3 TX$ 
Pl AUXP1 
TEXT AUXXA 


CMSSYS CNTRL L2 AUXLCL2 TX$ 
P2 AUXP2 
Pl AUXP1 
TEXT AUXXA 
L2 AUXLCL2 TX$ 
L3 AUXLCL3 TX$ 
P2 AUXP2 
P1 AUXP1 
HCPXYZ AUXLCLI PATCH3 TX$ APAR3 
HCPXYZ PATCH3 - | ./ * VER 24 4780,C204 
./ * REP 24 4760 | 
HCPXYZ AUXLCL2 PATCH2 TX$ APAR2 
./ * REP 254 4700 
./ * VER 260 5810,7042,5010 
HCPXYZ AUXLCL3 PATCH1 TX$ APAR1 
HCPXYZ PATCHI ./ * VER 254 4740,6062 
./ * REP 254 47F0 


L3 AUXLCL3 TX$ 
TESTSYS _ CNTRL L1 AUXLCL1 TX$ 

P3 AUXP3 

TEXT AUXXA 
HCPXYZ PATCH2 ./ * VER 254 47F0,6062 

./ * REP 260 58F0,7042,50F0 
HCPXYZ TEXT ESD 

TXT 

RLD 

END 


620 Installation and Service 


Patch Facility 


Example of Local Service to ASSEMBLE Files 


The following is an example of a control structure containing a temporary patch over a local source update. 
Although this works, it is not recommended. Whenever source code is available, you should use source 
updates instead of patches. 


= 


XASYS CNTRL L1 AUXLCL1 TX$ 


P1 AUXP1 
HCPXYZ AUXLCLI 


TEXT AUXXA 
TEMPO2 TX$ PROB1 
LCFIX5 TX$ APAR2 
HCPXYZ TEMP02 -/ * VER 24 4780,C204 
./ * REP 24 4700 
HCPXYZ LCFIX5 ./ ADD 12346000 
XYZLOOP TM FLAG,X'O1' CHECK COMPLETE 
BO DONE EXIT LOOP 


HCPXYZ TXTLI 
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PRELOAD MODULE 


The preloader is a utility program that runs under CMS. It collects multiple text files and reformats them 
into a single text file. The function of the preloader is similar to that of a linkage editor, but the output is in 
standard text file format and does not include multiple CSECTS. 


A program can be developed using separate assembly modules that reference each other. The preloader can 
then be used to combine the assembled text files into a single loadable text file. 


Format 


The format of the PRELOAD command is: 


PRELOAD loadlist [control] 


Where: 


loadlist 
specifies the filename of an EXEC on the caller’s A-disk or read-only extension containing records that 
define input to the preloader. Each of these records contains the filename and optionally the filetype of 
an input text file. The format of each loadlist record defining an input file must be: 


&l &2 filename filetype 


control 
optionally specifies the filename of a CNTRL file residing on one of the caller’s accessed disks. The 
format and interpretation of the CNTRL file is the same as that for the VM/SP VMFLOAD utility. It 
normally contains filetypes in priority sequence to be used for selecting input files if filetypes are not 
included in the loadlist file. The IBM-supplied control files are described in Chapter 7, “How VM/XA 
System Product Uses Control Files and Update Files” on page 361. 


Note: PRELOAD ignores records that have a PTF update level identifier. It then searches for the next 
lower level identifier to determine the filetype of the input text file. PRELOAD also ignores any 
options in the loadlist. 


Input 


The preloader gets input filenames from the loadlist. The filetype for each input file is determined in one of 
three ways: 


1. If the loadlist record for a given input file includes a filetype entry, that filetype is used to locate the 
record. 


2. If the loadlist record does not contain a filetype, and a “control” parameter was specified on the 
PRELOAD command line, the filetype constructed is in the format TXTxxxxx. In this case, xxxxx Is 
the highest control level identifier in the control file for which a file can be located on the caller’s 
accessed disks. 


3. If no filetype is specified on the loadlist entry, and a control file has not been specified on the 
PRELOAD command line, then the default filetype value is TEXT. 


Note: Input files are located by scanning the caller’s disks in their access order. All input files must be on 
accessed disks. 
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PRELOAD MODULE 


The preloader output consists of two files written to the caller’s A-disk: fn TEXT and fn MAP. 


The filename for each of these files is the same as that specified for the input loadlist file. If either of these 
files already exists on the caller’s A-disk, the new copy replaces the old one. 


TEXT File 


The output TEXT file is a merged and linked composite of the input files. The first CSECT or private code 
section in the input expands to contain all input files. Its length is the sum of the lengths of the input files, 
rounded up to doubleword multiples between sections. Input TXT records of non-zero length are relocated 
and written to the output file. 


The output RLD is a translated and relocated collection of all input RLD records. No sorting is done by the 
preloader. In general, each output ESD, TXT, and RLD entry appears in the same order as the 
corresponding input entry. ADCON and VCON fields are relocated within their TXT records. ORG 
statements that cause relocatable constant fields to overlay or be overlaid may cause results that differ from 
results obtained with a loader that completes TXT data loading prior to relocating ADCONs and VCONS. 


MAP File 


The output MAP file is a printable record of preloader processing, similar to a load map. The first line of 


the map contains: 


¢ Output text filename 


¢ Residence volume label and volume device address 


e Date and time of file creation. 


The next section of the map is a listing of the control file (if any) used. The remainder of the map contains, 
in processing order, a section for each input file. Each of these sections consists of: 


e Filename, filetype, filemode of input file 


e Residence volume label and virtual device address 


e Input file’s creation date and time 


e Any invalid input records. 


DMSPREOOLE 
DMSPRE002E 
DMSPRE104S 
DMSPRE105S 
DMSPRE109S 
DMSPRE183E 
DMSPRE234E 
DMSPRE235E 
DMSPREZ236E 
DMSPREZ237E 
DMSPRE238E 


No filename specified 

File fn ft fm not found 

Error nn reading file fn ft fm from disk 
Error nn writing file fn ft fm on disk 

Virtual storage capacity exceeded 

Invalid {CONTROL|AUX} file control card 
Error in LOAD LIST file {7 ft fm[; no input] 
Error n in input text file fn ft [fm] 
Unresolved external reference(s) encountered 
Duplicate external symbol(s) encountered 
Preloader processing error 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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SAMGEN EXEC 


The SAMGEN EXEC creates a segment that contains the simulated VSE modules necessary to support 
Sequential Access Method (SAM) data management (DTFSD), the ESERV utility program, and Virtual 
Storage Extended/Virtual Storage Access Method (VSE/VSAM),. 


To install this segment, called CMSBAM, use the SAMGEN EXEC procedure. 


Before you invoke SAMGEN EXEC, you need to define a virtual machine large enough to contain 
CMSBAM. To provide room for the loader tables, the size of the virtual machine should be at least 512K 
greater than the location at which you intend to save CMSBAM. However, you must not define your 
Storage larger than the address at which you loaded CMSDOS. 
SAMGEN EXEC performs the following operations: 
e Fetches the simulated VSE phases from the CMSBAM DOSLIB file, which is supplied as part of VM 
¢ Loads the simulated phases at the designated address 
¢ Assigns a storage protection key of X'F' 


e¢ Saves the segment. 
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SAMPNSS EXEC 


The SAMPNSS EXEC defines named saved systems. 


Format 


The format of the SAMPNSS EXEC is: 


CMS CMSXA 


CMSAMS 


Where: 


CMS CMSXA 
creates named saved systems for CMS and CMSXA at pages E00 — FFF. 


GCS 
creates a named saved system for GCS at pages 0—6 (exclusive) and 400 — 5FF (shared). 


CMSINST 
Creates a saved segment for CMSINST at pages C00 —C4F. 


HELP 
creates a saved segment for HELP at pages C50 —C9F in the INSTHELP segment space. 


CMSDOS 
creates a saved segment for CMSDOS at pages B00 — BOF in the DOSBAM segment space. 


CMSBAM 
creates a saved segment for CMSBAM at pages B10—- B3F in the DOSBAM segment space. 


CMSVSAM 
Creates a saved segment for CMSVSAM at pages BAO— BFF (shared) and A30—AFF (exclusive) in the 
DOSBAM segment space. 


agree a saved segment for CMSAMS at pages B40— B9F (shared) and A00— A2F (exclusive) in the 
DOSBAM segment space. 
The SAMPNSS EXEC: 
1. Defines the named saved systems or segments that you request 
2. Queries CP about the status of the named saved systems or segments 
3. Displays the status of the named saved systems or segments as shown below: 


OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE 
CMSMAINT nnnn = =NSS A- nnnn mnz:dd-= hh:mm_— nss NSS 
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Messages 

HCPNSD440I {Named Saved System (NSS)|Saved segment} systemname was successfully defined in fileid 
fileno. 

HCPNSS4401 {Named Saved System (NSS)|Saved segment} systemname was successfully saved in fileid 
fileno. 


Unrecognized Parameters passed — parm! parm2 
Explanation: SAMPNSS detected an error in the specified parameter. 


For information on error messages and codes, see VM/XA SP System Messages and Codes Reference. 
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SPLOAD EXEC 


The SPLOAD EXEC loads files from the product tapes according to the load instructions contained in 
SPLOAD PROFILE. SPLOAD PROFILE is described in this section. 


Format 


The format of the SPLOAD EXEC is: 


SPLOAD group element 2 | | 


* * 


‘Where: 


group element 
is a tape file identifier that SPLOAD EXEC uses to locate the entry in SPLOAD PROFILE that contains 
the load instructions for this tape file. 


fn [ft] 
form a file specification template. By default, both are set to asterisks (*), meaning all files within a tape 
file. However, they may be set to a specific filename and/or filetype to selectively load specific files from 
a tape file to a minidisk. 


SPLOAD PROFILE 


In the sample SPLOAD PROFILE, data entries are organized by format number (see definition below), and 
format number sets are separated by comment lines. A comment line begins with a slash asterisk (/*). Each 
data entry in SPLOAD PROFILE has the following syntax: 


group element userid address format volume  fileno 


Where: 


group element 
is a tape file identifier that identifies the profile entry containing the load instructions for this tape file. 


userid 
is the owner of the minidisk to which the tape file contents are loaded. This information is used only if 
SPLOAD EXEC must LINK and ACCESS the minidisk in order to load the file. 


address 
is the minidisk address to which the tape file is loaded. 


format 
is the tape format. SPLOAD PROFILE contains a complete load table for each tape format, describing 
the locations of the files on the product tapes. SPLOAD EXEC selects the appropriate entries in the 
profile depending on the user’s tape format. 


volume 
is the product tape volume on which the particular tape file resides. 
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fileno 7 
is the relative tape file number (location) of the specified tape file on the particular product tape volume. 
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! 6250 BPI VM/XA Merged Product Tape ! 
| emer n nnn mmm www www nnn ewe nn nn nnn ence n nw ne nn e wenn nnn none ene ocoenn- ! 
! 
! Volume 1 
f 
Memo Files MAINT 191 XASP20V1 1 2 
Install Tools MAINT 191 XASP20V1 1 3 
Sysgen Tools MAINT 193 XASP20V1 1 4 
System Samples MAINT 191 XASP20V1 1 5 
CPLOC Samples MAINT 295 XASP20V1 1 6 
CMSLOC Samples MAINT 395 XASP20V1 1 7 
CP Object MAINT 194 XASP20V1 1 8 
cP ‘Putapply MAINT 192 XASP20V1 1 9 
cP Putdelta MAINT 294 = XASP20V1 1 10 
cP Corapply MAINT 291 XASP20V1 1 11 
CP Cordelta MAINT 291 XASP2QV1 1 12 
DUMPVIEW Object MAINT 193 XASP20V1 1 13 
DUMPVIEW Putapply MAINT 392 XASP20V1 1 14 
DUMPVIEW Putdelta MAINT 293 XASP20V1 1 15 
DUMPVIEW Corapply MAINT 391 XASP20V1 1 16 
DUMPVIEW Cordelta MAINT 391 XASP20V1 1 17 
J 
! Volume 2 
! 
CMS Base MAINT 193 XASP20V2 2 2 
CMS Putapply MAINT 392 XASP20V2 2 3 
CMS Putdelta MAINT 293 XASP20V2 2 4 
CMS Corapply MAINT 391 XASP20V2 2 5 
CMS Cordelta MAINT 391 XASP20V2 2 6 
IOCP Files MAINT 193 XASP20V2 2 7 
CMS System MAINT 190 XASP20V2 2 8 
GCS Object MAINT 595 XASP20V2 2 ] 
GCS Interface MAINT 193 XASP20V2 2 10 
GCs Putapply MAINT 592 XASP20V2 2 11 
GCs Putdelta MAINT 596 XASP20V2 2 12 
GCs Corapply MAINT 491 XASP20V2 2 13 
Gcs Cordelta MAINT 491 XASP20V2 2 14 
AMENGHLP Files MAINT 19D XASP20V2 2 15 
UCENGHLP Files MAINT 19C XASP20V2 2 15 
! 

Figure 47 (Part 1 of 2): Sample SPLOAD PROFILE 
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! Volume 3 

! 

CP Source MAINT 394 XASP20V3 
CMS Source MAINT 393 XASP20V3 
DUMPVIEW Source MAINT 393 XASP20V3 
! 


MAINT R2MONLS 
MAINT R2MONLS 
MAINT ? R2MONLS 
MAINT R2MONLS 
MAINT R2MONLS 
MAINT R2MONLS 


Figure 47 (Part 2 of 2). Sample SPLOAD PROFILE 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643089 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in any 
one of these places, you must change it in all of them. We recommend that you do not change any 
addresses. 


Usage Notes 


1. SPLOAD must do a tape rewind each time it is invoked to make sure that the proper product tape is 
mounted and to be able to position the tape to the proper tape file. If the incorrect tape is mounted then 
SPLOAD will prompt for the proper product tape. 


The first tape file on each product tape contains a header file named STAPE$ HEADER. The first line 
of this file must be in the following format: 


TAPENO = n 3 TAPEFORMAT = f 
where n is the relative tape number and fis the tape format (for example, R1M05500). 


2. SPLOAD expects that the tape drive being used is ATTACHed at virtual address 181. If not, SPLOAD 
will not be able to continue. 


3. SPLOAD will ACCESS the target minidisk at an unused mode letter nearest the end of the alphabet. It 
will use Z if all modes are used. 


4. SPLOAD restores the minidisk access order to its original state just before exiting. However, SPLOAD 
will not be able to recreate mode extension situations. 


5. If SPLOAD does a LINK to a minidisk, followed by an ACCESS to that disk and receives a return code 
of 100 from the ACCESS, an attempt will be made to FORMAT the disk. 


SPLOAD will provide a minidisk label to FORMAT which will consist of the first 3 characters of the 
user ID which owns the minidisk, concatenated with a 3-digit minidisk address. If the minidisk address is 
four digits long, then only the first 2 characters of the user ID will be used. 


Note: For user ID MAINT, the default characters used will be either MNT or MT, depending on the 
size of the minidisk address. 
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Messages and Return Codes 


DMSWTK002E 
DMSWSL032E 
DMSWSLOS50E 
DMSWSL062E 
DMSWTK070E 
DMSWSG095E 
DMSWSL252E 
DMSWSL409I 

DMSWSL737R 
DMSWSL963E 
DMSWSL964R 


DMSWSL986I 


fn ft not found [RC =28] 


Invalid filetype ft [RC =24] 

Parameter missing after value [RC =24] 

Invalid character char in fileid fn [RC =20] 

Invalid parameter parameter [RC =24] 

Invalid address vaddr [RC = 100] 

Invalid filename filename [RC =24] 

Loading fn ft to the vdev disk attached to user id [RC =0] 
Enter the minidisk address for the group element [RC =0] 
keyword value not found in fn ft fm [RC =24] 

Wrong tape mounted; mount product tape n 

Press ENTER when the correct tape is mounted or type QUIT [RC =0] 
Unable to restore ACCESS to mdisk [RC =0] 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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UPDATE Command 


Use the UPDATE command to modify program source files. The UPDATE command accepts a source 
input file and one or more files containing UPDATE control statements and updated source records; then it 
creates an updated source output file, an update log file indicating what changes, if any, were made, and an 
update record file if more than a single update file is applied to the input file. 


Format 


The format of the UPDATE command is: 


fnl Ke 


hr [ fn2 [ft2 Lime) [(options... [) ]] 
ASSEMBLE | Al 


options: 


REP SEQ8 INC 
NOREP NOSEQS NOINC 


[iosn] [Rete] 


be | fouTMODE fm | 


Where: 

fal ftl fml 
is the file identifier of the source input file. The file must consist of 80-character card image records with 
sequence fields in positions 73-80 or 76—80. If the filetype or filemode is omitted, ASSEMBLE and Al 
are assumed, respectively. 

fn2 ft2 fr2 
is the file identifier of the update file. If the NOCTL option is in effect, this file must contain UPDATE 
control statements and updated source records. The default file identifier is fn] UPDATE Al. If the 
CTL option is specified, this file must be a control file that lists the update files to be applied; the default 
file identifier is frnl CNTRL Al. 


options: 
REP 


creates an output source file with the same filename as the input source file. If the output file is 
placed on the same disk as the input file, the input file is erased. 


NOREP 
retains the old file in its original form, and assigns a different filename to the new file, consisting of a 


dollar sign ($) plus the first 7 characters of the input filename (fn/). 
SEQS8 


specifies that the entire sequence field (columns 73 —80) contains an 8-digit sequence number on 
every record of source input. 


NOSEQS8 | 
specifies that columns 73 —75 contain a 3-character label field, and that the sequence number is a 


5-digit value in columns 76 — 80. 


Note: Source files sequenced by the CMS editor are sequenced, by default, with 5-digit sequence 
numbers. 
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INC 
increases sequence numbers in columns 73 — 80 in each record inserted into the updated output file, 
according to specifications in UPDATE control statements. 


NOINC 
puts asterisks (********) in the sequence number field of each updated record inserted from the 
update file. 


CTL 
specifies that fn2, ft2, and fm2 describe an update control file for applying multiple update files to the 
source input file. 


Note: The CTL option implies the INC option. 


NOCTL 
specifies that a single update file is to be applied to the source input file. 


OUTMODE fm 
specifies that UPDATE writes the files it creates on the fm disk. UPDATE writes the files as 
outlined in the note below. If you do not specify a filemode when using OUTMODE, the filemode 
number defaults to 1. This disk must be an accessed CMS read/write disk or UPDATE terminates. 


Note: UPDATE takes the following steps to determine the disk upon which it places output files. 
The search stops as soon as one of the following steps is successful: 


1. If you specify the OUTMODE option, then UPDATE places the output files on the 
specified disk. That disk must be read/write. If you accessed the disk as a read only 
extension, then UPDATE displays the following message: 


DMSUPDO37E DISK fm IS READ-ONLY 


2. If the disk on which the original source file resides is read/write, then UPDATE places 
the output files on that disk. 


3. If that disk is a read-only extension of a read/write disk, then UPDATE places the output 
files on that particular read/write disk. 


4. If neither of the other steps is successful, then UPDATE places the output files on the 
primary read/write disk (the A-disk). 
STK 
stacks information from the control file in the CMS console stack. STK is valid only if the CTL 


option ts also specified and is useful only when the UPDATE command is executed in an EXEC 
procedure. 


NOSTK 
does not stack control file information in the console stack. 


TERM 
displays warning messages at the terminal whenever a sequence or update control card error 1s 
discovered. (Such warning messages appear in the update log whether or not they are displayed at 
the terminal.) 


NOTERM 
suppresses the display of warning messages at the terminal. However, error messages that terminate 
the entire update procedure are displayed at the terminal. 


DISK 
places the update log file on disk. This file has a file identifier fr UPDLOG, where /m is the filename 
of the file being updated. 


PRINT 
prints the update log file directly on the virtual printer. 
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STOR 
specifies that the source input file is to be read into storage and the updates performed in storage 
prior to placing the updated source file on disk. This option is meaningful only when used with the 
CTL option since the benefit of increased processing speed is realized when processing multiple 
updates. STOR is the default when CTL is specified. 


NOSTOR 
specifies that no updating is to take place in storage. NOSTOR 1s the default when single updates 
are being applied (CTL is omitted from the command line). 


Update Control Statements 


The UPDATE control statements let you insert, delete, and replace source records, as well as resequence the 
output file. 


All references to the sequence field of an input record refer to the numeric data in columns 73 — 80 of the 
source record, or columns 76 —80 if NOSEQ8 is specified. Leading zeros in sequence fields are not required. 
If no sequence numbers exist in an input file, a preliminary UPDATE with only the “./ S” control statement 
can be used to establish file sequencing. 


Sequence numbers are checked while updates are being applied; an error condition results if any sequence 
errors occur in the update control statements, and warnings are issued if an error is detected in the 
sequencing of the input file. Any source input records with a sequence field of eight blanks are skipped, 
without any indication of a sequence error. Such records may be replaced or deleted only if they occur 
within a range of records that are being replaced or deleted entirely and if that range has limits with valid 
sequence numbers. There is no means provided for specifying a sequence field of blanks on an UPDATE 
control statement. 


Control Statement Formats: 


All UPDATE control statements are identified by the characters “./” in columns | and 2 of the 80-byte 
record, followed by one or more blanks and additional, blank-delimited fields. Control statement data must 
not extend beyond column 50. 


SEQUENCE Control Statement 


Use the sequence control statement to resequence the updated source output file in columns 73 —80 (if SEQ8 
is specified), or in columns 76 —80 with the label placed in columns 73 —75 (if NOSEQ8 is specified). 


The format of the SEQUENCE control statement is: 


./ S f[seqstrt [seqincr [label}]] 


Where: 


seqstrt 
is a 1- to 8-digit numeric field specifying the first decimal sequence number to be used. The default value 
is 1000 if SEQ8 is specified and 10 if NOSEQ8 is specified. 


seqincr 
is a 1- to 8-digit numeric field specifying the decimal increment for resequencing the output file. The 
default is the segstrt value. 
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label 
is a 3-character field to be duplicated in columns 73-75 of each source record if NOSEQ8 is specified. 
The default value is the first 3 characters of the input filename (fn/). 


If you use the SEQUENCE statement, it must be the first statement in the-update file. If any valid control 
statement precedes it, the resequence operation is suppressed. 


When the sequence control statement is the first statement processed, the sequence numbers in the source file 
are checked and a warning message is issued for any errors. If the sequence control statement is processed 
after updates have been applied, no warning messages will be issued. 


Each source record, including unchanged records from the source file and records inserted from the update 
file, is resequenced in columns 73 — 80 as it is written onto the output file. 


INSERT Control Statement 


Use the insert control statement to insert all records following it, up to the next control statement, into the 
output file. 


The format of the INSERT control statement is: 


-/ I seqno [$ [seqstrt [seqincr]]] 


Where: 


seqno 
is the sequence number of the record following which new records are to be added. 


is an optional delimiter indicating that the inserted records are to be sequenced by increments. 


seqstrt 
is a 1- to 8-digit numeric field specifying the first decimal number to be used for sequencing the inserted 
records. 


seqincr 
is a 1- to 8-digit numeric field specifying the decimal increment for sequencing the inserted records. 


All records following the “./ I” statement, up to the next control statement, are inserted in the output file 
following the record identified by the segno field. If the NOINC option is specified, each inserted record is 
identified with asterisks (********) in columns 73-80. If either the INC or CTL option is specified, the 
records are inserted unchanged in the output file, or they are sequenced according to the segstrt and seqincr 
fields, if the dollar sign ($) key is specified. 


The default sequence increment, if the dollar sign is included, is determined by using one tenth of the least 
significant, nonzero digit in the seqno field, with a maximum of 100. The default segstrt is computed as segno 
plus the default segincr. For example, the control statement: 


./ 1 2600 $ 2610 


causes the inserted records to be sequenced XXX02610, XXX02620, and so forth (NOSEQ8 assumed here). 
For the control statement: 


./ 1 246800 $ 


the defaulted segincr is the maximum, 100, and the starting sequence number is 240100. SEQ8 is assumed, so 
the inserted records are sequenced 00240100, 00240200, and so forth. 
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If either INC or CTL is specified but the dollar sign ($) is not included, whatever sequence number appears 
on the inserted records in the update file is included in the output file. 


DELETE Control Statement 


Use the delete control statement to delete one or more records from the source file. 


The format of the DELETE control statement is: 


-/ D segnol [seqno2] [$] 


Where: 


seqnol 
is the sequence number identifying the first or only record to be deleted. 


seqno2 
is the sequence number of the last record to be deleted. 


A 


is an optional delimiter indicating the end of the control fields. 


All records of the input file, beginning at seqgno/, up to and including the segno2 record, are deleted from the 
output file. If the segno2 field is omitted, only a single record is deleted. 


REPLACE Control Statement 


Use the replace control statement to replace one or more input records with updated records from the update 
file. 


The format of the REPLACE control statement is: 


-/ R seqnol [seqno2] [$ [seqstrt [seqincr]]] 


Where: 


seqnol 
is the sequence number of the first input record to be replaced. 


seqno2 
is the sequence number of the last record to be replaced. 


A 


is an optional delimiter key indicating that the substituted records are to be sequenced incrementally. 


seqstrt 
is a 1- to 8-digit numeric field specifying the first decimal number to be used for sequencing the 
substituted records. 


seqincr 
is a 1- to 8-digit numeric field specifying the decimal increment for sequencing the substituted records. 


All records of the input file, beginning with the segno/ record, up to and including the seqno2 record, are 
replaced in the output file. They are replaced with the records that follow the “./ R” statement in the update 
file, and precede the next control statement. 
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As with the “./ D” (delete) function, if the seqno2 field is omitted, only a single record is replaced, but it may 
be replaced by more than a single inserted record. The “./ R” (replace) function is performed as a delete 
followed by an insert: thus, the number of statements inserted need not match the number deleted. The 
dollar sign ($), segstrt, and segincr processing is identical to that for the insert function. 


COMMENT Statement 
Use the comment statement to insert comments into the file. 


The format of the COMMENT statement is: 


Where: 


* 


indicates that this is a comment statement and is only copied into the update log file. 


Summary of Files Used by the UPDATE Command 


The following discussion shows input and output files used by the UPDATE command for a: 


¢ Single-level update 
¢ Multilevel update 
* Multilevel update with an auxiliary control file. 


Single-Level Update 


fn ASSEMBLE fn ASSEMBLE 
fn UPDATE fn UPDLOG 
update fn 
Where: 
fn ASSEMBLE 
is the source input file. 
fn UPDATE 
contains UPDATE control statements and updated source input records. 
$fn ASSEMBLE 


is the updated source file, incorporating changes, additions, and deletions specified in the update file. 
The output filetype is always the same as the filetype of the input file. These default filetypes and 
filemodes can be overridden on the command line; for example: 


update testprog cobol b fix cobol b (rep s 


results in a source file TESTPROG COBOL B being updated with control statements contained in the 
file FIX COBOL B. The output file replaces the existing TESTPROG COBOL B. 
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fn UPDLOG 


contains a record of updates applied. If you do not want this file written on disk, specify the PRINT 
option. 


Multilevel Update 


fin ASSEMBLE $fn ASSEMBLE 
fn CNTRL fn UPDLOG 
fn UPDTABC fn UPDATES 
fn UPDTXYZ 


update fn (ctl 


Where: 


fn ASSEMBLE 
is the source input file. 


fn CNTRL 
is the control file that lists updates to be applied to the source file. These default filetypes and filemodes 
can be overridden on the command line; for example: 


update acct pliopt a test cntr] a (ctl @ 


results in the file TEST CNTRL being used by the UPDATE command to locate the update files for 
ACCT PLIOPT. 


fn UPDTABC 

fn UPDTXYZ 
are update files containing UPDATE control statements and new source records. These files must have 
filenames that are the same as the source input file. The first 4 characters of the filetype must be UPDT. 
The UPDATE command searches all accessed disks to locate the update files. 


$fn ASSEMBLE 
is the updated source file, incorporating changes, additions, and deletions specified in the update files. 
The filetype is always the same as the filetype of the source input file. 


fn UPDLOG 
contains a record of updates applied. If you do not want this file written on disk, specify the PRINT 
option. 


fn UPDATES 
summarizes the updates applied to the source file. 


The CONTROL FILE (fn CNTRL) may not contain UPDATE control statements. It may only list the 
filetypes of the files that contain UPDATE control statements. This control file contains the records: 


TEXT MACS maclibname 
TWO UPDTABC 
ONE UPDTXYZ 


where UPDTABC and UPDTXYZ are the filetypes of the update files. The UPDATE command applies 
these updates to the source file beginning with the last record in the control file. Thus, the updates in fn 
UPDTXYZ are applied before the updates in fm UPDTABC. 
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When you create update files whose filetypes begin with UPDT, you may omit these characters when you list 
the updates in the control file; thus, the CNTRL file may be written: 


TEXT MACS maclibname 
TWO ABC 
ONE XYZ 


TEXT, TWO, ONE: The first column of the control file consists of an update level identifier, which may be 
from 1 to 5 characters long. These identifiers are used by VM updating procedures, like the VMFHASM 
EXEC, to locate and identify text decks produced by multilevel updates. 


MACS: The first record in the control file must be a MACS record that contains an update level identifier 
(TEXT) and, optionally, lists up to nine macro library (MACLIB) filenames. 


UPDATE uses the information provided in the MACS card and the update level identifier only when the 
STK option is specified. This information is, however, required in the CNTRL file. 


Multilevel Update with Auxiliary Control File 


fn ASSEMBLE 


fn CNTRL $fn ASSEMBLE 
fin UPDTABC fn UPDLOG 
fn UPDTXYZ fin UPDATES 
fn AUXLIST 

fn FIX01 

fn FIX02 


update fn (ctl 


jn ASSEMBLE, fn CNTRL, fn UPDTABC, fn UPDTXYZ, $/fn ASSEMBLE, fn UPDLOG, and fn 
UPDATES are used as described for “Multilevel Update”, except that the CNTRL file contains: 


TEXT MACS maclibname 
TWO UPDTABC 
ONE UPDTXYZ 
TEXT AUXLIST 


AUX in the filetype AUXLIST indicates that this is the filetype of an auxiliary control file that contains an 
additional list of updates. The first 3 characters of the filetype of an auxiliary control file must be AUX; the 
remaining characters (to a maximum of 5 characters) may be anything. The filename must be the same as 
the source input file. 
An auxiliary file may also be specified as: 

XXXXX AUX 
in the control file. For example, the record: 

FIX TEST AUX 
identifies the auxiliary file fn AUXTEST. 


Note: If you give an auxiliary control file the filetype AUXPTF or an update level identifier of AUX, the 
UPDATE command assumes that it is a simple update file and does not treat it as an auxiliary file. 
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Preferred AUX File 


A preferred AUX file may be specified. A preferred AUX file contains the version of an update that applies 
to your version of the source file. (There may be more than one version of the same update if there is more 
than one version of the source file. For example, you need one version for the source file that has a system 
extension program product installed, and you need another version for the source file that does not have a 
program product installed.) 


When you specify an auxiliary control file, you can specify more than one filetype. The first filetype indicates 
a file that UPDATE uses only on one condition: the files that the second and subsequent filetypes indicate 
do not exist. If they do exist, this AUX file entry is ignored and no updating is done. The files that the 
second and subsequent filetypes indicate are preferred because, if they exist, UPDATE does not use the file 
that the first filetype indicates. For example, assume that the file fn ASSEMBLE does exist. The control file 
MYMODS CNTRL: 


TEXT MACS MYMACS maclibname 
MY2 AUXTEST 
MY1 AUXMINE AUXTEST 


and the command: 
update fn assemble * mymods cntr1 (ctl @ 


would result in UPDATE finding the preferred auxiliary control file fn AUXTEST, and therefore not using 
Jn AUXMINE to update fn ASSEMBLE. UPDATE would then proceed to the MY2 AUXTEST entry and 
update fn ASSEMBLE with the updates listed in fn AUXTEST. It is assumed that AUXTEST and 
AUXMINE list similar, but mutually exclusive, updates. 


The search for a “preferred” AUX file will continue until one is found or until the token is an invalid 
filetype; that is, less than 4 or more than 8 characters. This token and the remainder of the line are 
considered a comment. 


Jn FIXO1 and fm FIX0O2 are update files containing UPDATE control statements and new source records to 
be incorporated into the input file. When update files are listed in an auxiliary control file, they can have any 
filetype you choose, but the filename must be the same as the source input file. The update files, as well as 
the AUX file, may be on any accessed disk. These are indicated in fn AUXLIST as follows: 


FIXO2 
FIXO1 


The updates are applied from the bottom of the auxiliary control file. Thus, fn FIXO1 1s applied to the 
source file before fn FIX02. Since the auxiliary control file is listed at the bottom of the control file, these 
updates are applied before UPDTXYZ and UPDTABC. 


Additional Control File Records 
In addition to the MACS record, the filetypes of update (UPDT) files, and the filetypes of auxiliary control 
(AUX) files, a control file may also contain: 


¢ Comments. These records begin with an asterisk (*) in column |. Comments are also valid in AUX files. 


e PTF records. If the characters PTF appear in the update level identifier field, the UPDATE command 
expects the second field to contain the filetype of an update file. The filetype may be anything; the 
filename must be the same as the source input file. 


e Update level identifiers not associated with update files. 
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The following example of a control file shows all the valid types of records: 


* Example of a control file 
ABC MACS MYLIB 

TEXT 

004 UPDTABC 

003 XYZ 

002 AUXLIST1 

001 LIST2 AUX 

PTF TESTFIX 


The STK Option 


The STK (stack) option is valid only with the CTL option and is meaningful only when the UPDATE 
command is invoked within an EXEC procedure. 


When the STK option is specified, UPDATE stacks the following data lines in the console stack: 


first line: * update level identifier 
second line: * library list from MACS record 


The update level identifier is the identifier of the most recent update file that was found and applied. For 
example, if a control file contains: 


TEXT MACS DMSGPI. DMSOM OSMACRO OSPSI TESTMAC 
OFA UPDTOFA 
PFA UPDTOFA 


and the UPDATE command appears in an EXEC as follows: 


UPDATE SAMPLE (CTL STK &READ VARS &STAR &TEXT &READ VARS 
&STAR &LIB1 &LIB2 &LIB3 &LIB4 &LIBS &LIB6 . 


then the variable symbols set by the {READ VARS statements have the following values if the file SAMPLE 
UPDTOFA is found and applied to the file SAMPLE ASSEMBLE: 


Symbol Value 
&STAR * 

&TEXT OFA 
&LIB1 DMSGPI 
&LIB2 DMSOM 
&LIB3 OSMACRO 
&LIB4 OSPSI 
&LIBS TESTMAC 
&LIB6 null 


The library list may be useful to establish macro libraries in a subsequent GLOBAL command within the 
EXEC procedure. If no update files are found, UPDATE stacks the update level identifier on the MACS 
record. | 


FILE fn ft fm, REC #n = update control statement 


Explanation: This message is displayed when the TERM option is specified and an error is detected in an 
update file. It identifies the file and record number where the error is found. 
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Return Codes 


The UPDATE command issues the following return codes: 


Return Code | Possible Causes 


¢ No filename specified 
e Input file sequence error 


¢ Sequencing overflow 
e Sequence increment is zero 
e Sequence error introduced in output file 


— 
ho 


we ed No 


e Premature EOF of file; sequence number not found 
¢ Missing PTF file 

e ./s not first card in input file; card ignored 

¢ Invalid char in sequence field 

e Sequence number not found 

e Invalid update file control card 


¢ Invalid option 

¢ Invalid mode 

¢ Option specified twice 

¢ Conflicting options 

¢ Invalid parameter 

¢ Option STK invalid without CTL 


e File not found 
¢ File UPDATE CMSUT1 fm already exists 


e File is not fixed, 80-character records 
¢ Missing or duplicate MACS card in control file 
¢ Invalid file control card 


bo 


e Disk is read-only 

e Disk not accessed 

e No update files were found 

e Insufficient storage to begin update 

e Insufficient storage to complete update 
e Error reading file from disk 

¢ Error writing file on disk 
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The UTILITY EXEC provides occasionally used installation utility functions: 


Printing the system definition files 


Creating a stand-alone service utility tape for either or both DSF and DDR 


¢ Writing a backup IPLable copy of the CP nucleus to tape 


Creating CP load list 

Generating the following utilities: 

ADDMAP CPEREPXA CPFMTXA 
DIRECTXA DUMPLOAD DUMPSCAN 
HCPCCU HCPLDR HCPSADMP 
IPL DDRXA MAP MONWRITE 
PRTDUMP RETRIEVE SCAN 


3CARD LOADER 


Format 


The format of the UTILITY EXEC is: 


UTILITY PRSAMPLE 


| 

UTILTAPE DSF 

DDR 

NUCTAPE 

CPLOAD CPFMTXA 
HCPSADMP 


ALL 
CPEREPXA 
DIRECTXA 
DUMPLOAD 
GENIMAGE 
HCPCCU 
HCPLDR 
IMAGELIB 
DDR 
MONWRITE 
OVERRIDE 
RETRIEVE 
3CARD LOADER 


ALL 
ADDMAP 
DUMPSCAN 
DVFGEND MAP 
PRIDUMP 
SCAN 
TRACERED 


DTYPE vdev 
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DOR 

GENIMAGE 
IMAGELIB 
OVERRIDE 
TRACERED 


UTILITY EXEC 


Where: 


PRSAMPLE 
prints the following system definition files: 


e USER DIRECT 

¢ DMSNGP ASSEMBLE 
¢ HCPRIO ASSEMBLE 

e HCPSYS ASSEMBLE. 


These files are spooled to the system printer. The minidisks containing these files must be accessed 
before using the PRSAMPLE operand. 


UTILTAPE 
creates a tape containing any or all of the following stand-alone utility programs: 


e Device Support Facility (DSF) 
e DASD Dump/Restore program (DDRXA). 


Each IPLable program is written as a separate tape file, with one or more tape marks separating the 
programs. Therefore, when you IPL a program off the tape, you may have to IPL more than once to 
bypass the tape marks. 


NUCTAPE 
writes a backup IPLable copy of the CP nucleus to tape. 


CPLOAD 
creates the CP load list, which has a file name of CPLOAD and a file type of EXEC. 


GEN 
creates any of the following stand-alone utility programs on disk from their associated object modules 
(text decks): 


CPEREPXA MODULE, the error recording module 

CPFMTXA MODULE, the module that CP-formats minidisks for CP use 
DIRECTXA MODULE, the user directory program 

DUMPLOAD MODULE 

GENIMAGE MODULE 

HCPCCU MODULE 

CMS version of the system loader (HCPLDR MODULE) and the stand-alone version of the system 
loader (HCPLDR LOADER) 

Stand-alone dump program (HCPSADMP) 

IMAGELIB MODULE 

370-XA version of the DASD DUMP RESTORE program (IPL DDRXA) 
DDR MODULE ; 

MONWRITE MODULE 

OVERRIDE MODULE 

RETRIEVE MODULE 

3 CARD LOADER. 


UTILITY GEN ALL creates all the programs listed except CPFMTXA MODULE and HCPSADMP. 


DVFGEND 
creates any or all of the following modules: 


ADDMAP MODULE 
DUMPSCAN MODULE 
MAP MODULE 
PRTDUMP MODULE 
SCAN MODULE 
TRACERED MODULE. 
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DTYPE vdey 


issues a DIAGNOSE code X'24' for the specified virtual device address, uses the returned information 
to look up the DASD type in the $3DASD$ CONSTS file, and returns that information to the terminal (if 
UTILITY DTYPE is issued from the terminal) or to the program stack (if UTILITY DTYPE is called 
by another EXEC). If the DASD type cannot be determined using DIAGNOSE code X'24', the same 
search is performed using DIAGNOSE code X'210' 


Only VM/XA-installation-supported DASD types are represented in $DASD$ CONSTS. The 
information returned is a single line consisting of three fields: 


¢ DASD type and model 
¢ The proper representation of the given DASD model to the CPFORMAT program. 


If the virtual device address is invalid, nonexistent, or addresses an unsupported device type, a nonzero 
return code is displayed. 


The UTILITY DTYPE function is intended primarily for use by installation-related utilities. 


Usage Notes 


é 


l. If you specify ALL for the GEN option, UTILITY generates all of the utilities listed under the GEN 
option, except CPFMTXA MODULE and HCPSADMP. If you specify ALL for the DVFGEND 
option, UTILITY generates all of the utilities listed under the DVFGEND option. 


2. UTILITY creates HCPLDR MODULE and LOADER by assembling the associated files. It generates 
all other modules from the associated text deck. The text deck must be on an accessed disk before 
UTILITY is run. You must run SETUP EXEC, then VMFSETUP EXEC with the CP ALL parameters, 
to establish the appropriate minidisk access order. 


Messages and Return Codes 


DMSWUT002E 
DMSWUTOS0E 
DMSWUTO70E 
DMSWUTO9SE 
DMSWUTS338E 
DMSWUT340E 
DMSWUT971E 
DMSWUT9721 
DMSWUT973R 
DMSWUT974I 
DMSWUT975I 
DMSWUT976I 
DMSWUT9801 
DMSWUT986I 


File fn ft not found [RC = 28] 

Parameter missing after value [RC =24] 

Invalid parameter parameter [RC =24] 

Invalid address vaddr [RC =24] 

Generating a new /n ft will not be attempted [RC = 28] 

file name has not been created [RC =24] 

Unable to locate fn ft [RC =24] 

jn ft fm spooled the printer [RC =0] 

Enter the minidisk address where the IPL decks were loaded [RC =0] 
Unable to find IPL decks on the minidisk you indicated [RC = 0] 
Moving /n ft to tape [RC =0] 

The fn ft program is on tape file number number [RC=0] 

An IPLable CP nucleus now exists on tape [RC =0] 

Unable to restore ACCESS to mdisk [RC =0] 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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VMFAPPLY EXEC 


Use the VMFAPPLY EXEC to create auxiliary control files for the PTFs you want to apply to VM/XA 
System Product. 


Format 


The format of the VMFAPPLY EXEC is: 


VMAPPLY prodid [compname} [updateid] [(options... [) ]] 


options: 


put] {setup | [exciupe | [cueck 7 [Los 
COR| | NOSETUP} | NOEXCLUDE| | NOCHECK| {NOLOG| 


Where: 


prodid 
is the product to be serviced. The prodid for VM/XA System Product Release 2.1 is 56643089. 


compname 
is the component to be serviced. The names for the VM/XA System Product Release 2.1 components are 
CP, CMS, GCS, and DV. 


updateid 
is the filetype of the auxiliary control files. It should match a filetype listed in the CNTRL file. If you 
do not specify an update ID, VMFAPPLY will use the update ID in the product parameter file. 


options: 
PUT 
indicates that you are applying program update service. PUT is the default. 


COR 
indicates that you are applying COR service. 


SETUP 
specifies that a new minidisk access order will be set up. SETUP is the default. 


NOSETUP 
specifies that a new minidisk access order will not be set up. You must set the correct access order 
up yourself. 


EXCLUDE 
means that PTFs listed in the exclude list will not be applied. EXCLUDE is the default. 


Note: If two PTFs are in the same text deck, you cannot exclude the first unless you also exclude 
the second, even if you list the first one on the exclude list. This restriction applies because 
the first PTF is considered to be a prereqisite for the second PTF. 


If you list the first PTF in the exclude list, but not the second, and if the second PTF appears 
in the apply list, both PTFs will be applied. You will receive an error message indicating that 
a PTF you wanted to exclude has been applied. 


NOEXCLUDE 
means that the exclude list will be ignored. 
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CHECK 
means that all the checks that can be specified in the product parameter file will be performed. 


NOCHECK 
means that none of the checks that can be specified in the product parameter file will be performed. 


LOG 
specifies that error messages will be written both to the apply exception log and, if critical, to the 
terminal. LOG is the default. 


Notes: 
1. Noncritical messages are written only to the apply exception log, not to the terminal. 


2. Messages issued by the VMFOVER and VMSETUP EXECS, which VMFAPPLY invokes, are 
written only to the terminal, not to the apply exception log. 


NOLOG 
specifies that error messages will be written only to the terminal. 


Note: Options specified on the VMFAPPLY command override the options specified in the product 
parameter file. 


How VMFAPPLY Works 


Figure 48 on page 647 is an overview of VMFAPPLY processing. 
Verifying the Apply List 


First, VMFAPPLY checks that the apply list is an appropriate apply list for program update service if you 
specified PUT, or for corrective service if you specified COR. If it is the wrong apply list, a message is 
issued. 


Creating the Temporary PPF 


VMFAPPLY calls VMFOVER to create a copy of the appropriate component section of the product 
parameter file with overrides. If the product has more than one component and no component was specified, 
you are shown a list of components and asked to choose one. This copy is used instead of the original 
product parameter file. 


User Exit 


A user exit EXEC call for setup and cleanup is provided. The user EXEC is identified in the PPF by the 
‘USEREXIT. tag. If an EXEC name follows the :USEREXIT. tag, that EXEC is called at the beginning and 
end of the VMFAPPLY EXEC. A separate EXEC can be provided for each component. VMFAPPLY 
passes parameters indicating the receive function and either setup or cleanup, and a return code from 
VMFAPPLY. Examples of such calls might be: 


MYEXEC VMFAPPLY SET-UP 
MYEXEC VMFAPPLY CLEAN-UP rc 
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$SAPP/SEXCLIST $PTFPART $PPF HCPxxx TXTptfno 


‘HCPSCH TXT01927’ 
H3DD86HP PUT UMD1885 
PREREQ: VM28823 


HCPSCH H12345HP 
HCPSCH TXT01927 


UMO01885 
UM01886 


UM01927 HCPALF TXT01927 
ai dace CO-REQ: NONE 


ESD ... 


- VMFAPTXT 
VMFAPPLY - VMFAPNLS 
- VMFAPCOM 


AUXXA 
.FM UPDATE 
.DEPEND REQ 
-RENAME TEXT 


Figure 48. How VMFAPPLY Works 
Minidisk Accesses 


VMFAPPLY invokes VMFSETUP (unless you specified NOSETUP) to save your current disk access order 
and build a new disk access order based on the product parameter file. (The product parameter file should 
be on a system disk accessed in your current search order, preferably your A-disk.) The new search order is: 


TASK disks 
APPLY disks 
DELTA disks 
LOCAL disks 
BASE disks 
BUILD disks 
SYSTEM disks. 


The PTF Parts List 
VMFAPPLY obtains the first PTF entry from the apply list. If the entry is not on the exclude list, 
VMFAPPLY locates the PTF parts list by using the PTF number (7 characters) for filename and $PTFPART 


for filetype. VMFAPPLY works through the PTF parts list one at a time and calls the specific part handler 
based on entries in the PPF part type list. 


After the PTF is applied, the filemode of the PTF parts list is changed to filemode 5. The procedure is 
repeated for each entry in the apply list. 


If the :;CKUPD tag in the product parameter-file is set to NO, and the filemode of the PTF parts list is 5, no 
processing is performed on the PTF. 
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Part-Specific EXECs 


VMFAPPLY invokes four part-specific EXECs (called part handlers). These part handlers are invoked once 
per part listed in the PTF parts list. The filetype of the part determines which part handler is used: 


1. VMFAPAUX supports AUX files in the apply function. 
2. VMFAPTXT supports text parts in the apply function. 
3. VMFAPNLS supports text parts that require national language support in the apply function. 


4. VMFAPCOM is a common EXEC that insures the existence of parts that do not have specific processing 
but are listed in the PTF parts list. 


VMFAPAUX EXEC: VMFAPAU%X is invoked once for each AUX file in each $PTFPART list processed 
during the execution of VMFAPPLY. 


VMFAPAUX locates the cumulative AUX file that contains the given PTF number. If this file does not 
exist, VMFAPAUX creates it. VMFPAUX validates the AUX file by commenting out duplicates which exist 
at lower AUX file levels. (These comments are located in the newly created file). If duplicate AUX files 
exist at higher levels, VMFAPAUX issues a message in the apply exception log. 


VMFAPAUX adds included PTFs to the $SAPPINCL list, adds depend entries to requisite update files, adds 
requisite update files that don’t have a filemode of 5 to the SAPPREQ list, and changes the filemode of the 
update file to 5. 


If the file contains new service, VMFAPAUX copies the new AUX file to a file with the filetype listed in the 
:UPDTID tag of the PPF. 


Applying service to a CMS MACRO or COPY file results in an “M” being inserted after the third character 
of the specified CMS control file. 


VMFAPCOM EXEC: VMFAPCOM is called to locate parts named in the PTF parts list for which no other 
specific processing is provided. Any part not found is listed in the exception log. The filemode is not 
changed to 5 because this is not a true apply (that is, no AUX structure is built) and there is no 
corresponding VMFBLD step. 


VMFAPTXT EXEC: VMFAPTXT first looks for an existing AUX file (for the specified module and at the 
specified update level) in the APPLY disk sequence. If the AUX file exists on the current apply disk, it is 
used as a base and additional entries are added to it. If the existing AUX file is on an earlier disk in the 
sequence, it is copied onto the current disk and used as a base. If none exists, a new file is created. 


VMFAPTXT gets the latest APAR entry (at the bottom of the text deck prolog) and checks the filemode of 
the update file. If the filemode number is 5, the APAR has already been applied. No further processing is 
required for that deck. If the filemode is 1, the entry is inserted at the top of the list of AUX file entries and 
the filemode number is changed to 5. If the update file is not found, it is created and a message is inserted in 
the apply exception log. | 


The update files should be found on either the DELTA or the APPLY disks. If they exist on the DELTA 
disk, source service is available. If they are on the APPLY disk, they are OCO modules with object service 
only. Changing the filemode from x1 to x5 indicates that the APAR has been applied (listed in an AUX 
structure). All applied OCO updates have the filemode of the APPLY disk; and ail applied source updates 
have the filemode of the DELTA disk. All updates that have not been applied, but that do exist on the 
DELTA or APPLY disk, have the filemode x1. 


The names (derived from APAR numbers) of update files in which prereq and coreq entries appear are 
entered in the requisite update files as DEPEND entries tf the prerequisites and corequesites are in the same 
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component as the update being applied. This will facilitate the backout of a bad fix and avoid leaving a 
dependent fix without its requisites. If the requisite file is not found, an entry is made in the apply exception 
log. Requisites (prereq, coreq, ifreq) that are outside the component will be put in a list to be stored in the 
apply exception log. 


VMFAPTXT proceeds to process all entries (working from bottom to top) in the text deck prolog until an 
already-applied entry (one whose filemode is 5) is encountered. Each succeeding entry from the text deck is 
inserted behind the last entry moved from the current text deck, but ahead of any entries that may have come 
from previous text decks. If the PTF number in any included entry is not in the apply list (minus the exclude 
list), a message is put in the apply exception log. 


If CKTXT is specified in the PPF, and if the top AUX entry is being applied at this time, (that is, not 
previously applied as indicated by filemode 5 on the update file that was listed in the text deck prolog) 
VMFAPTXT checks to see if the text deck is a full text deck or a shell only. If it is a shell only, the module 
name is added to the apply exception log as a missing text deck. If it is a full text deck, VMFAPTXT checks 
to see if this full text deck supersedes any listed in the apply exception log as missing text decks, in which 
case the module name is purged from the log. VMFAPTXT reads and writes directly to the log on the user’s 
A-disk. 


After all entries have been processed, a search is made for AUX files at higher control file entries. AUX files 
at these CNTRL file entries may represent local modifications or local text patches. The AUX file filename 
and filetype are listed in the apply exception log along with all entries from the AUX file. 


Finally, VMFAPTXT searches the build lists in the BLD section of the PPF for the text deck filename. If 
the filename of the text deck being processed is found, a message is be put in the SVMFAPP SERRLOG 
indicating what build list the text deck was found in. This allows the user to easily determine what parts can 
be built using VMFBLD. 


After processing is complete, control returns to VMFAPPLY. 


If the name is not found in the list, the deck is copied with the rename filetype from the third column of the 
PPF entry in the apply section to allow compatibility with current MODULE build support. If a deck with 
the rename filetype already exists, the self-documenting prologs are compared to determine the superset deck 
that should contain all entries from the other deck. The superset deck is kept with the renamed filetype 
either by retaining the existing renamed deck or by copying the new deck with the REPLACE option. 


After the copy, VMFAPTXT returns to VMFAPPLY. 


VMFAPNLS EXEC: VMFAPNLS first creates an AUX filename by concatenating the text filename with a I- 
or 2-character NLS suffix based on the text filetype prefix. If the filetype prefix is TAM, the language is 
mixed-case American English and the suffix is null. All other NLS filename suffixes are based on the file 
VMEFNLS LANGLIST S, which is resident on MAINT’s 190 disk and shown in Figure 49. 


American English 
Kanji 
Uppercase English 


Brazilian Portuguese 
French 
German 


Figure 49. VMFNLS LANGLIST File 


VMFAPNLS then looks for an existing AUX file (with the AUX filename created in the previous step and 
the specified update identifier) in the APPLY disk sequence. If the AUX file exists on the current APPLY 
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disk, it is used as a base and additional entries are added to it. If the existing AUX file is on an earlier disk 
in the sequence, it is copied onto the current disk and used as a base. If none exists, a new file is created. 


VMFAPNLS gets the latest APAR entry (at the bottom of the text deck prolog) and checks the filemode of 
the update file. If the filemode number is 5, the update has already been applied. No further processing is 
required for that deck. If the filemode is 1, the entry is inserted at the top of the list of AUX file entries and 
the filemode number is changed to 5. If the update file is not found, it is created and a message is inserted in 
the apply exception log. 


The update files should be found on either the DELTA or the APPLY disks. If they exist on the DELTA 
disk, source service is available. If they are on the APPLY disk, they are OCO modules with object service 
only. Changing the filemode from x1 to x5 indicates that the APAR has been applied (listed in an AUX 
structure). All applied OCO modules have the filemode of the APPLY disk; and all applied source modules 
have the filemode of the DELTA disk. All modules that have not been applied, but that do exist on the 
DELTA or APPLY disk, have the filemode x1. 


The names (derived from APAR numbers) of update files in which prereq and coreq entries appear are 
entered in the requisite update files as DEPEND entries if the prerequisites and corequesites are in the same 
component as the update being applied. This will facilitate the the backout of a bad fix and avoid leaving a 
dependent fix without its requisites. If the requisite file is not found, an entry is made in the apply exception 
log. Requisites (prereq, coreq, ifreq) that are outside the component will be put in a list to be stored in the 
apply exception log. 


Messages indicating a requisite outside the component have a prefix of RO. These are not error messages, 
but informational messages issued so that you are sure to find all the requisites. 


VMFAPNLS proceeds to process all entries (working from bottom to top) in the text deck prolog until an 
already-applied entry (one whose filemode is 5) is encountered. Each succeeding entry from the text deck is 
inserted behind the last entry moved from the current text deck, but ahead of any entries that may have come 
from previous text decks. If the PTF number in any included entry is not in the apply list (minus the exclude 
list), a message is put in the apply exception log, and the PTF is added to a supplemental apply list (called jn 
S$APPINCL) to be processed after the main apply list. 


If CK TXT is specified in the PPF, and if the top AUX entry is being applied at this time, (that is, not 
previously applied as indicated by filemode 5 on the update file that was listed in the text deck prolog) 
VMFAPNLS checks to see if the text deck is a full text deck or a shell only. If it is a shell only, the module 
name is added to the apply exception log as a missing text deck. If it is a full text deck, VMFAPNLS checks 
to see if this full text deck supersedes any listed in the apply exception log as missing text decks, in which 
case the module name is purged from the log. VMFAPNLS reads and writes directly to the log on the user’s 
A-disk. 


After all entries have been processed, a search is made for AUX files at higher control file entries. AUX files 
at these CNTRL file entries may represent local modifications or local text patches. The AUX file filename 
and filetype are listed in the apply exception log along with all entries from the AUX file. 


Finally, VMFAPNLS copies the deck with the NLS filetype indicated in the PPF. If a deck with the NLS 
filetype already exists, the self-documenting prologs are compared to determine the superset deck that should 
contain all entries from the other deck. The superset deck is kept with the NLS filetype either by retaining 
the existing NLS text deck or by copying the new deck with the REPLACE option. 


After the copy, VMFAPNLS returns to VMFAPPLY. 
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Return Codes 


VMFAPPLY issues the following return codes: 


Return Code ; Explanation 


A message of type CK, WN, RO, or BD was encountered. Check $VMFAPP 
$SERRLOG. | 


et There was syntax error in the command. 


There was an unexpected tag in PPF. . 
The required file was not found. 
An unrecoverable error was encountered. 
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VMFBLD EXEC 


Use the VMFBLD EXEC to build the nucleus during installation and to rebuild the nucleus after applying 
service. VMFBLD invokes $VMFPATS, which invokes the HCPLDR command. 


Format 


The format of the VMFBLD EXEC is: 


VMFBLD {prodid [compname] [bldist] }[ (options... [)]] 


options: 


pau CHECK {LOG 7 [DISK 
oseTuP_| LNOCHECK} LNOLOGJ | TAPE 


PUNCH 


Where: 


prodid | 
is the product to be serviced. The prodid for VM/XA System Product Release 2.1 is 56643089. 


compnaine 
is the component whose nucleus is to be rebuilt. 


The names for the VM/XA System Product Release 2.1 components are CP, CMS, GCS, and DV. 


bldlist 
is the loadlist or buildlist for the nucleus or module you wish to rebuild. If you do not specify bidlist, all 
entries for the component will be processed. 


options: 


SETUP 
specifies that a new minidisk access order will be set up. 


NOSETUP 
specifies that a new minidisk access order will not be set up. You must set the correct access order 
up yourself. 


CHECK 
means that all the checks that can be specified in the product parameter file will be performed. 


NOCHECK 
means that none of the checks that can be specified in the product parameter file will be performed. 


LOG 
specifies that error messages will be written both to the build exception log and, if critical, to the 
terminal. 


Notes: 
1. Noncritical messages are written only to the build exception log, not to the terminal. 


2. Messages issued by the VMFOVER and VMSETUP EXECs, which VMFBLD invokes, are 
written only to the terminal, not to the build exception log. 
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NOLOG 
specifies that error messages will be written only to the terminal. 


DISK 
specifies that the nucleus will be written to the target disk specified in the product parameter file. 
This must be the same disk specified on the SYSRES macro in the HCPSYS file (for CP) or the 
DMSNGP profile (for CMS). 


TAPE 
specifies that the nucleus will be written to tape 0182 in card image format. 


PUNCH 
specifies that the nucleus will be spooled to your virtual card reader. 


Note: Options specified on the VMFBLD command override the options specified in the product 
parameter file. | 


How VMFBLD Works 


MAIN CNTRL LOAD LIST $PPF TEXT 


:>MDA. ‘ACPLCK TXT01895’ 
*BLD. ‘ACPSCH TXT01927’ 


‘CPLOAD EXEC’ 
&1 &2 &3 HCPLDR 
&1 &2 &3 HCPSYS 


‘ACPXA CNTRL’ 
TEXT MACS 


TEST AUXTST 
LCL AUXLCL 
TEXT AUXXA 


CPLOAD “HCPALF TXT01927’ 
&1 &2 &3 HCPRIO sila 


| - CALL VMFBDNUC 
- CREATE TEMP LOAD LIST 
VMFBLD - ESTABLISH SEARCH ORDER 
- CHECK REQUISITES 
- CALL HCPLDR 


> 
a 


Figure 50 (Part 1 of 2). How VMFBLD Works 
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PICK UP 


ENTRY FROM GO DOWN 
‘ACPXA CNTRL’ ONE LEVEL 
TEXT MACS IN CNTRL 


yyy AUXzzz 


IS 
HCPxxx AUXzzz 
THERE? 


TAKE FIRST ENTRY 
IN AUX TO FIND 
OUT PTF NO. 


KS 
‘HCPxxx TXTptfno’ SELECT TEXT 


THERE? 


“ACPxxx TXTyyy’ 


COMPARE INFO OF 
HCPxxx AUXzzz 


V.S. 
“HCPxxx TXTptino’ 


ERROR 


SELECT TEXT 


‘ACPxxx TXTptfno’ 


Figure 50 (Part 2 of 2). How VMFBLD Works 
Creating the Temporary PPF 


VMFBLD calls VMFOVER to create a copy of the appropriate component section of the product parameter 
file with overrides. This copy is used instead of the original product parameter file. 


User Exit 


A user exit EXEC call for setup and cleanup ts provided. The user EXEC is identified in the PPF by the 
“USEREXIT. tag. If an EXEC name follows the : USEREXIT. tag, that EXEC is called at the beginning and 
end of the VMFBLD EXEC. A separate EXEC can be provided for each component. VMFBLD passes 
parameters indicating the receive function and either setup or cleanup, and a return code from VMFBLD. 
Examples of such calls might be: | 


MYEXEC VMFBLD SET-UP 
MYEXEC VMFBLD CLEAN-UP rc 
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Minidisk Accesses 


VMFBLD then invokes VMFSETUP (unless you specified NOSETUP) to save your current access list and 
establish a new list based on the product parameter file. The new access order is: 


TASK disks 
LOCAL disks 
APPLY disks 
DELTA disks 
BASE disks 
BUILD disks 
SYSTEM disks. 


Part-Specific EXECs 


VMFBLD invokes the following part-specific EXECs: 
¢ VMFBDNUC creates a temporary load list and invokes the system loader. 
¢ VMFBDCPY copies the PTF-numbered TEXT deck to the BUILD disk. 


VMFBDNUC EXEC: VMFBDNUC creates a new (temporary) load list named $$$TLL$$ EXEC that 
contains both filename and filetype to pass to HCPLDR. VMFBDNUC will call the VMFLDS MODULE 
to perform a search for the TEXT decks to load and create the temporary load list. 


When the temporary load list has been completed, the list of requisites within the component is processed as 
follows if the CHK REQ option has been specified. The list of requisite APARs is created by the VMFLDS 
MODULE. 


1. VMFBDNUC creates actual update filetypes by combining the numeric portion of the APAR number 
with the system and version level from the PPF. For example: 


APAR number VM12345 

System and version (and alternate) S/DK A/XX 

Numeric portion of APAR number 12345 

Possible update filetypes $12345DK 
A12345XX 


2. VMFBDNUC creates a list of update files by filename and filetype. For example: 


listfile * S12345DK * @ 
MODABC $12345DK 
MODXYZ $12345DK 
listfile * A12345xXX * @ 
MODDEF A12345XX 


3. VMFBDNUC locates MODABC, MODXYZ and MODDEF in the temporary load list and obtains the 
filetype (PTF level) of the text deck included in the nucleus build. 


4. VMFBDNUC searches the self-documenting prolog of the text deck to be sure that the APAR number 
(in this exampie, 12345) is included. If not, a message is put in the build exception log. 


After requisite checking has completed, VMFBDNUC calls the $VMFPATS$ EXEC with the new load list 
containing filenames and filetypes of text to be loaded. SVMFPATS looks for patches that need to be 
applied to text decks in the load list. Any patches found are inserted into the appropriate text deck and 
included in the IPL deck produced by the loader. 


When the loader has completed punching the text decks, control returns to VMFBLD. 
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VMFBDCPY EXEC: VMFBDCPY will be used to copy the PTF-numbered TEXT deck to the BUILD disk . 
identified in the PPF. VMFBDCPY calls VMFLDS to create a new (temporary) load list named $$$TLLSS 
EXEC, which contains both the filenames and filetypes of text decks to load. Requisite checking is 
performed as in VMFBDNUC. VMFBDCPY then invokes the COPYFILE command to copy the 
PTF-numbered deck to the BUILD disk and to rename it. These files must reside on the BUILD disk with a 
filetype of TEXT. 


Return Codes 
VMFBLD issues the following return codes: 


No errors were encountered. 


4 A message of type CK, WN, RO, or BD was encountered. Check VMFBLD 
SERRLOG. 


| there was a yn enorinie command 
[100 | An unrecoverable ror was eneomiend SSS 
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VMFHASM EXEC 


The VMFHASM EXEC updates a specified source file according to entries in a control file, and assembles 
the updated source file. VMFHASM invokes the CMS UPDATE command, then assembles the updated 
source file using Assembler H Version 2. If you wish, VMFHASM can use the product parameter file to 
establish the minidisk search order. 


Format 


The format of the VMFHASM EXEC is: 


fin aie } [fpseraend | 
prodid __ [compname] options 
options: 


PPF SETUP KEEPSRC 
CTL NOSETUP NOKEEPSRC 


assembler options: 


DISK TERM LIST [EXP] [XREF] 
PRINT | | NOTERM NOLIST 


DECK RENT 
NODECK NORENT 


Where: 


fn 
is the filename of the source file to be updated. It must have a filetype of ASSEMBLE. 


etlfile 
is the filename of the control file. The control file must have a filetype of CNTRL. Ifa product 


parameter file exists with a filename of prodid, the name of the CNTRL file will be found in the product 
parameter file under “Compname.” You do not have to specify the ctlfile parameter. 


prodid 
is the product identifier. The prodid for VM/XA System Product Release 2.1 is 56643089. 


compname 
is the component name specified in the product parameter file. The names for the VM/XA System 
Product Release 2.1 components are CP, CMS, GCS, and DV. 


options: 


PPF 
indicates that the second parameter is a product parameter filename. If neither CTL nor PPF ts 
specified, the VMFHASM EXEC searches for a file whose name is the same as the second 
parameter. If such a file is found, its filetype determines whether it is a control file or a product 
parameter file. If both exist, the product parameter file is used. 


CTL 
indicates that the second parameter is a control filename. 
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SETUP 
specifies that a new minidisk access order will be set up. 


NOSETUP 
specifies that a new minidisk access order will not be set up. You must set the correct access order 
up yourself. 


KEEPSRC 
indicates that the merged source file consisting of the updates and the base source file will be saved 
on the user’s disk. The file is named $filename filetype, where filename is the original source input 
filename and filetype is the original source input filetype. 


NOKEEPSRC 
does not save the merged source file. 


assembler options: 


DISK 
places the listing file on a virtual disk. 


PRINT 
writes the listing file to the printer. 


TERM 
writes the diagnostic information on your display. The diagnostic information consists of the 
diagnosed statement followed by the error message issued. 


NOTERM 
suppresses the TERM option. 


LIST 
produces an assembler listing. 


NOLIST 
does not produce an assembler listing. 


DECK 
creates an object module. 


NODECK 
suppresses the DECK option. 


RENT 
checks the program for a possible violation of program reenterability. An error message identifies 
code that makes the program nonreenterable. 


NORENT 
suppresses the RENT option. 


EXP 
prints all macro expansions. By default, macro expansions are not printed. 


XREF 
causes the XREF(FULL) option to be invoked when VMFHASM invokes the assembler. The 
default for VMFHASM is XREF(SHORT). 


How VMFHASM Works 


The steps taken by the VMFHASM EXEC are summarized below: 


1. If a product parameter file is used, VUFHASM calls VMFOVER to create a copy of the appropriate 
component section of the product parameter file with overrides. This copy is used instead of the original 
product parameter file. 
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VMFHASM then invokes VMFSETUP (unless you specified NOSETUP) to save your current disk 
access order and build a new disk access order based on the product parameter file. 


2. The VMFHASM EXEC calls the UPDATE command, which includes the CTL, STK, and PRINT 
options. ' 


UPDATE uses the control file (ctifile CNTRL) to update the assembler language source file. The new 
_ file is named $/n ASSEMBLE. 


UPDATE stacks information from the control file in the console stack, and prints the update log file. 


3. Using the library list from the MACS record in the control files VMFHASM issues a GLOBAL 
MACLIB command. 


4. The updated source file, $fn ASSEMBLE, is assembled using the options indicated on the VMUFHASM 
command line. 


5. The output text deck from the assembly, $/n TEXT, is concatenated with the UPDATES file so that the 
text deck contains a history of update activity. 


6. UPDATE stacks the identifier of the most recent update it found and applied. (If no updates were 
found, UPDATE stacks the identifier of the MACS record in the main control file instead.) If no PTF 
number or local tracking number is available. VMFHASM uses this update level identifier to determine 
how to rename $/n TEXT. 


If a product parameter file was specified (or used by default), and if the update was listed in an auxiliary 
control file containing the PTF number or local tracking number, the text deck is renamed fn xxxnnnnn, 
where xxx is the text filetype prefix from the corresponding record in the main control file and mnnnn is 
the PTF number or local tracking number. The default textfile type prefix is TXT. 


If a control file was specified (or used by default); or if the PTF number or local tracking number is not 
available, and if the update level identifier is TEXT, the text deck is renamed fn TEXT. If the update 
level identifier is anything other than TEXT, the text deck is renamed fn TXT xxxxx (where xxxxx is the 
1- to 5-character update level identifier). 


7. Temporary files ($f: ASSEMBLE and fn UPDATES) are erased. 


The input and output files used by VMFHASM are summarized below: 


Input and Output Files 


Disk Input Files 


jn ASSEMBLE Assembler language source 
jn CNTRL Control file 

jn MACLIB Macro library 

fn AUXxxxxx Auxiliary control files 

fn UPDTxxxx Update files 

Jn SPPF Product parameter file. 


Disk Output Files 


fn {TEXT|TXTxxxxx} Object deck, named according to the update level identifier in the control file. 
This file also contains data from the UPDATES file, together with date and time 
information. It is placed on the A-disk, which you must access in read/write 
mode before issuing VMFHASM. 


Appendix B. EXEC and Command Format Summaries 659 


VMFHASM EXEC 


Printer Output Files 


$fn LISTING Assembler listing Gf PRINT option is in effect). This file also contains data from the 
update log file (f2 UPDLOG), describing the updates applied to the source file. 


The UPDATE command issues messages to indicate when each update file is applied. 


ASMBLING fn 


Explanation: The assembly is going to begin. If you specified any assembler option on the VMFHASM 
command line, the options used are also displayed. 


Jn {TEXT |TXTxxxxx} CREATED 
Explanation: This message indicates the filename and filetype of the text deck. 


Note: If the source is on some other R/W minidisk instead of the A minidisk, VMFHASM will not create a 
text deck identifying the update level on the A minidisk. 
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VMFLKED EXEC 


The VMFLKED EXEC procedure invokes the CMS LKED command to link-edit modules into a 
LOADLIB. VMFLKED uses the normal CMS search order when searching for TEXT files. 


Format 


The format of the VMFLKED EXEC is: 


VMFLKED fn Ih | | [(options...[)]] 


LKEDCTRL 


* 


options: 


[PRINT] [MODULE module_name } 


Where: 


jn 
is the filename of the input control file. You must specify a filename. 


ft 
LKEDCTRL 
is the filetype of the input control file. The default filetype is LKEDCTRL. 


fm 
% 

is the filemode of the input control file. The default filemode is *. 
options: 


PRINT 
prints out a hard copy of the linkage-editor output. 


MODULE module_name 
indicates that only those members of the LOADLIB that include module_name are to be link-edited. 


How VMFLKED Works 


VMFLKED reads the specified LKEDCTRL file and expects to find option records (if any are needed) 
followed by linkage-editor input records. Multiple groups of options followed by linkage-editor input can be 
combined in a single LKEDCTRL file (see Figure 51 on page 664). 


1. VMFLKED processes the option records, which are identified by a percent sign (%) in column one. 


2. VMFLKED processes linkage-editor input records when it finds a nonoption and noncommentary 
record. 


When VMFLKED finds: 


e An INCLUDE record, the process adds the record to the linkage-editor input file and issues a 
FILEDEF for the TEXT file 


¢ A NAME record, the process adds the record to the linkage-editor input file and invokes the linkage 
editor 
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¢ A commentary record (beginning with *), the process ignores the record 
e Any other record, the process adds the record to the linkage-editor input file 


3. VMFLKED continues with Step I to process the next group of option records (if any). 


Input and Output Files 
Input Files 
Jn TEXT The name of the TEXT file. When the process finds an INCLUDE statement in the 


linkage-editor input control file, it issues a FILEDEF for that TEXT file. The 
linkage editor reads this TEXT file. 


jn LKEDCTRL A modified linkage-editor file. INCLUDE cards include TEXT files, and you 
cannot use them to include files from a library. Any record containing an asterisk 
(*) in column one is commentary and the process ignores it. 


The VMFLKED EXEC also recognizes special control (option) records in the 
linkage-editor control file (see Table 19). These records, which must begin with a 
percent sign (%) in column one, may only be located between linkage-editor input 
files (that is, groups of them may be at the beginning of the file or following a 
NAME record). 


| Table 19 (Page 1 of 2). Linkage-Editor Control File Special Control (Option) Records sd 19 (Page 1 of 2). | Table 19 (Page 1 of 2). Linkage-Editor Control File Special Control (Option) Records sd Control File Special Control (Option) Records 


Y% CONTROL control_file_name This record indicates to take the filetypes for 
linkage-editor input files from a control file. The 
name of the control file is specified on the 
“CONTROL record and the filetype is CNTRL. 
When the % CONTROL record is read, 
VMFLKED reads the control file and uses the 
first “word” of each line of the file to build an 
array of filetypes. The first line of the file 
indicates the default filetype. Each of the filetypes 
is checked and if it is not TEXT, the characters 
TXT are put at the beginning. When an 
VMFLKED finds an INCLUDE card, it searches 
the array. VMFLKED uses the first filetype from 
the array that matches an existing file. 

This option is in effect until a %Y% NOCONTROL 
record is found. 


%NOCONTROL This record indicates not to take the filetype for 
linkage-editor input files from a control file. 

“%LIBRARY load_library_name This record changes the LOADLIB to be used and 
the name on the LKEDIT listing. The default for 
the LOADLIB name is the filename of the 
LKEDCTRL file. 

%LEPARMS link-edit parameters This record sets the link-edit parameters used in 
each link-edit step. If no parameters are specified, 

| none are used. 
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Table 19 (Page 2 of 2). (eee Control File Special Control (Option) Records 


%MAXRC maximum _ _ | return_code This record sets the maximum valid return code. 


The VMFLKED EXEC checks this value when it 
7 


ends. If the highest return code is higher than this 
value and is not listed on the *ACCEPTRC 
_ 
— So 


record, the EXEC issues a warning message. 
% ERASE 


Note: The %ERASE control statement takes effect immediately, and erases whatever is the current 
LOADLIB. The LOADLIB is not erased if you use the MODULE option. (The LOADLIB can be 
changed using the %LIBRARY control statement). 


This record lists the acceptable return codes for 
VMFLKED processing. (The return codes are 
usually higher than entry on the %MAXRC 
entry). VMFLKED checks the values after each 
link-edit. If the return codes after any link-edit 
are higher than the %MAXRC record and not 
specified on the SACCEPTRC record, 
VMFLKED issues a warning message at the end 
of its processing. 


This record causes the EXEC to bypass the 
warning message for missing TEXT files. Once 
specified, this record takes effect for all subsequent 
link-edits (or until a % NOIGNORE record is 
found). 


This record causes a warning message to be issued 
if there is a missing TEXT file. Once specified, 

this record takes effect for all subsequent link-edits 
(or until a % IGNORE record is found). 


This record erases LOADLIB and LKEDIT files. 
This is useful when you rebuild the LOADLIB as 
it keeps the LOADLIB and LKEDIT files as smali 
as possible. If this record is not specified, the 
LOADLIB and LKEDIT files are not erased. 


Output Files 

jn LOADLIB The main output from the linkage editor. This file contains the link-edited load 
modules. 

jn LKEDIT The file that contains the linkage-editor map for all modules. 
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The following is an example of a LKEDCTRL file. 


*CONTROL YOURCTRL 


%LIBRARY NCCF 
%ERASE 
“MAXRC 4 


%ACCEPTRC 12 14 


%LEPARMS NCAL LIST XREF LET RENT 
~ INCLUDE DSIZDST 
INCLUDE DSIZSHP 
INCLUDE DSILUTRM 
ORDER DSIZDST 
ENTRY DSIZDST 
NAME DSIZDST(R) 
%LEPARMS NCAL LIST XREF LET REUS 
INCLUDE DSIVMCMD 
INCLUDE DSIVMMSG 
ORDER DSIVMCMD 
ENTRY DSIVMCMD 
NAME DSTVMCMD (R) 


% IGNORE 


%LEPARMS NCAL LIST XREF LET RENT 
INCLUDE DSIPRTVM 
ENTRY DSIPRTVM 
NAME DSIPRTVM(R) 


Figure 51. Example of a LKEDCTRL file 


Messages 


DMSWLK002E 
DMSWLK002W 
DMSWLK0O03E 
DMSWLKO0SE 
DMSWLKO10E 
DMSWLKO65E 
DMSWLK842E 
DMSWLK843I1 
DMSWLK844E 
DMSWLK845W 


DMSWLKS846I 


File fn ft [fm] not found 

File fn ft not found 

Invalid option opt 

No {LKEDCTRL|MODULE} specified 
Premature EOF on file fn ft 
{PRINT|MODULE} option specified twice 

No {control|library} filename found in fn ft [fm] 
An invalid control record was found and ignored: 
No linkedit performed 

Errors were encountered during the link edit processing that will probably make the loadlib 
unusable 

LKED target_module into library 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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VMFMAC EXEC 


The VMFMAC EXEC updates macro libraries. It invokes the CMS UPDATE command to update specified 
copy! or macro files, according to entries in a control file, and then builds a new macro library from the 
resulting new versions of those files. 


Format 


The format of the VMFAC EXEC is: 


libname ([ctlfile] 


Where: 


libname | 
is the filename of the macro library to be updated, and of the EXEC file that contains the names of the 
library members. The entries in libname EXEC must be in the following format: 


&1 &2 fnl 
&1 &2 fn2 


where fnl, fn2, and so on, are filenames of macro or copy files to be updated and included in the macro 
library, which must have a filetype of MACLIB. 


ctlfile 
is the filename of a control file to be used to apply the updates. The filetype must be CNTRL. 


How VMFMAC Works 


1. VMFMAC locates libname EXEC and the control file. It also erases any existing files named NEWMAC 
MACLIB and NEWMAC COPY. VMFMAC begins reading the macro or copy filenames from the 
EXEC, beginning at the bottom. 


2. For each entry in the libname EXEC, VMFMAC: 
e Invokes the UPDATE command with its CTL option to apply the updates specified in the control 


file 
e Adds the updated macro or copy file ($file name MACRO or $filename COPY) to the macro library 
NEWMAC MACLIB 


¢ Adds the UPDATES file created by the UPDATE command to the file NEWMAC COPY 
e Erases $filename MACRO or $filename COPY, and filename UPDATES 


= 


Copy files are collections of assembler statements that many modules use in common. In source listings, the 
assembler includes copy files by a “COPY copyfilename” statement. They are similar to macro definitions because 
they reside in libraries, but they contain no substitution data. VM/XA System Product uses copy files to define 
control block DSECTS, data areas, and tables. | 
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3. 


If there are no update files corresponding to a macro or copy file entry specified in libname EXEC, the 
macro or copy file is added to NEWMAC MACLIB in its current form. NEWMAC COPY, containing 
a history of updates applied by VMFMAC, is added to NEWMAC MACLIB. 


. If no errors occur during the procedure, and when all the macros have been added to NEWMAC 


MACLIB, erase libname MACLIB, if it exists, and rename NEWMAC MACLIB to libname MACLIB. 


If errors occur during the VMFMAC EXEC procedure (for example, if a MACRO or a COPY file is not 
found), /ibname MACLIB is not erased, and the updated macro library retains the name NEWMAC 
MACLIB. 


Input and Output Files 

Disk Input Files 

libname EXEC List of macro or copy files to be updated or included (or both) in /ibname MACLIB 
ctifile CNTRL Control file used by the UPDATE command 

Jn MACRO Files to be updated or included (or both) in the macro library. 

Jn COPY 

Auxiliary control files 

Update files 

Disk Output Files 

libname MACLIB Updated macro library 

libname COPY Contains the UPDATE files produced by UPDATE command processing. 
Printer Output Files 


The printer is spooled with the CONT option so that when VMFMAC completes, the printer file contains: 


A copy of the control files 
The update log file for each updated macro or copy file the UPDATE command produced 
A copy of each macro or copy file in the macro library 


The libname COPY file, which contains the accumulated UPDATES files the UPDATE command 
created. 


Notes: 


1. 


When VMFMAC adds files with MACRO filetypes to a MACLIB, the EXEC takes the membername 
from the macro prototype statement. When VMFMAC adds files with COPY filetypes to a MACLIB, 
the EXEC follows these rules: 


a. If the membername is from the COPY file and updates were found, the membername is $filename. 

b. If the membername is from the COPY file and no updates were found, the membername is filename. 

c. If you include a *COPY statement as the first record in the file, the membername is that designated 
on the *COPY statement. The format of the *COPY statement is: 


*COPY membername 
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2. If errors occur during VMFMAC processing, consult the NEWMAC COPY file printed by VMFMAC. 
If you can correct the errors involving one or two macro or copy files, you can use the MACLIB 
command to add these members to NEWMAC MACLIB. Then erase the current libname MACLIB and 
rename NEWMAC MACLIB to libname MACLIB. 


3. If any accessed disk contains a MACRO file and a COPY file with the same name, the MACRO version 
is used. 


The UPDATE command issues the message DMSUPD178I to inform you of the updates being applied to 
each macro or copy file. If no updates are found, message DMSUPD181E is issued. 


fn {COPY|MACRO} ADDED 


Explanation: The specified macro or copy file has been added to the macro library. 


libname COPY ADDED 


Explanation: /ibname COPY, containing the update history of the MACLIB, has been added to the macro 
library. 


Appendix B. EXEC and Command Format Summaries 667 


VMFMERGE EXEC 


VMFMERGE EXEC 


The VMFMERGE EXEC procedure applies PTFs (program temporary fixes) from the DELTA disk to the 
MERGE disk. 


Do not use this procedure to service any of the base components of VM/XA SP. Use this procedure when 
applying PTFs to System Network Architecture (SNA) products. 


VMFMERGE requires a service control file (pt(num SCF) for each requested PTF and its requisites. The 
service control file contains instructions for applying the PTF. To use VMFMERGE, you must access the 


minidisk containing the prodid VMFPARM file. This file identifies the minidisks that VMFMERGE must 
access to service each product. 


Format 


The format of the VMFMERGE EXEC is: 


prodid pal Lee bed } [ EXCLUDE exclist] 


PTFLIST applist NOHIST 


Where: 


prodid 
is the ID of the product you specify. 


You cannot specify a prodid of EXCLUDE, because EXCLUDE is a keyword for this EXEC. 


PIF [ptf{num|*] 
applies a single PTF if you specify a PTF filename (pt/num). If you enter an asterisk (*) instead of a 
PTF filename, you will apply all PTFs for the product, as listed in the apply list, called prodid APPLIST, 
supplied on the service tape. You cannot specify a filename of EXCLUDE, because EXCLUDE is a 
keyword for this EXEC. 


If the service tape contains an exclude list file named prodid EXCLIST, any PTF listed in that file is not 
applied. 
PTFLIST applist 


applies the selected PTFs listed in the apply list file, applist APPLIST. If you specify a filename of 
EXCLUDE, you cannot use the EXCLUDE option to specify an Exclude List. 


If the service tape contains an exclude list file named prodid EXCLIST, any PTF listed in that file is not 
applied. 


HIST 
includes apartext comments from the SCF files in the text decks processed. The apartext lines from the 
SCF files are included at the beginning of each text deck as comments. This option is effective for the 
duration of the command. All text decks processed during the VMFMERGE process will include 
apartext entries as comments. 


NOHIST 
does not include apartext lines from the SCF files as comments in the text decks processed. This option 
is effective unless specifically overridden with the HIST option. 
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EXCLUDE exclist 
excludes the selected PTFs listed in the exclude list file, exclist EXCLIST. PTFs listed in prodid 
EXCLIST are excluded, in addition to those in the user-specified exclude list. If you specify EXCLUDE 
as the apply list filename, you cannot use the EXCLUDE option to specify an exclude list. 


If you use prodid EXCLIST as the name of your exclude list, then VMFMERGE ignores any other 
prodid EXCLIST file, including the one that may be supplied on the service tape, during processing. You 
should therefore use some other name for the exclude list you create. 


Note: If two PTFs are in the same text deck, you cannot exclude the first unless you also exclude the 
second, even if you list the first one on the exclude list. This restriction applies because the first 
PTF is considered to be a prereqisite for the second PTF. 


If you list the first PTF in the exclude list, but not the second, and if the second PTF appears in 
the apply list, both PTFs will be applied. You will receive an error message indicating that a PTF 
you wanted to exclude has been applied. 


How VMFMERGE Works 


VMFMERGE is a service process that processes PTFs. The EXEC procedure: 


1. Uses the parameter file (prodid VMFPARM) to determine the virtual address of the merge and delta 
disks. 


2. Checks the merge log to insure that the PTF you select is not already merged or superseded. 


3. Reads the service control file to get the prerequisite and corequisite PTFs and the elements affected by 
this PTF. 


e If the service control file for any of the prerequisite or corequisite PTFs is missing, processing for the 
current PTF stops. 


e Ifa prerequisite or corequisite PTF is in the exclude list, the current PTF is not merged. 


e Ifa prerequisite or corequisite PTF has been superseded, that prerequisite or corequisite is not 
merged. 


e If the requisite is not within this product, the system displays a message indicating that the requisite © 
PTF must be merged at some later time. 


e When you merge a PTF that is a requisite of a change in another product, be sure to note this 
requisite information. There is no automatic way to tell you of this cross-product requisite if at a 
later time you remove the change that is a requisite of a change in another product. 


4. Does the necessary COPY/RENAME from the delta disk to the merge disk for each element in the 
prerequisite and corequisite chain that was not superseded or already merged. 


Note: Temporary files are created during this COPY/RENAME process to insure system integrity. 
These files are erased during normal VMFMERGE processing. 


5. Adds service history to the element if it is a text deck. Element history consists of text deck comments 
containing: 


e The PTF or APAR number 
e A time and date stamp 
e Any apartext information that was in the service control file SCF. 


Note: A temporary file (SAPARTXT $VMFMERG) is created during this history process to ensure 
system integrity. VMFMERGE erases this file during normal! processing. 


6. Updates the reqby log to reflect all the requisite relationships of all the merged and superseded PTFs. 
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7. Marks in the merge log any ZAPs and PTFs that are superseded by this PTF. Those ZAPs and PTFs 
are never applied. 


8. Puts entries in the merge log to show which PTFs have been merged. 


Notes: 


1. You can issue VMFMERGE to process a single PTF, a list of PTFs, or all PTFs on the input disk for a 


product. 


wa F&F Ww bh 


. Merged PTFs cannot be excluded, but can be superseded. 
. Superseded PTFs cannot be merged nor excluded. 
. PTFs in the Exclude List can be superseded. 


. If the following conditions are both true: 


a. VMFMERGE has the HIST option specified, and 
b. LKED does not have the LET option specified, 


error message IEW0222 will not occur and there will not be linkage editor errors due to comments 


(invalid card). 


Messages 


DMSWMG002E 
DMSWMG008E 
DMSWMG017E 
DMSWMGS20E 
DMSWMGS45E 
DMSWMG649E 
DMSWMG653E 
DMSWMG856E 


DMSWMG857E 
DMSWMGS858E 
DMSWMG859E 
DMSWMG860E 
DMSWMGS&é6ll 
DMSWMG862I 
DMSWMG863E 
DMSWMG864E 
DMSWMG864I 
DMSWMG864W 
DMSWMG865I 
DMSWMG86é6W 
DMSWMG867E 
DMSWMG868E 
DMSWMG869E 
DMSWMG870E 
DMSWMG871E 
DMSWMG872E 
DMSWMG873E 


DMSWMG874E 


DMSWMG88Z2W 
DMSWMG883W 
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File fn ft [/m] not found. 

Device vdevno invalid or nonexistent. 

Invalid device address vdevno. 

Invalid operand: operand. 

Missing operands. 

Extraneous parameter parm. 

Error executing command. 

Disk address vdevno is listed more than once on the DELTA and/or MERGE entry records 
in the prodid VMFPARM file. 

The number of disk addresses on the DELTA entry record cannot exceed nine. 

Unable to find a tag entry record in the /n /t file. 

The prodid VMFPARM file has no disk addresses on the {MERGE|DELTA} entry record. 
Only one {MERGE|DELTA} entry record may appear in the prodid VMFPARM file. 
Accessing disk_type disk vdevno as fm. 

Change name has been action. 

The MERGE disk vdevno must be linked read-write. 

PTF name will not be action because it already is status. 

PTF name will not be action because it already is status. 

PTF name will not be action because it already is status. 

Processing PTF name. 

No PTFs have been action. 

Invalid status status in prodid VMFMGLOG for entry pj. 

PTF name is not a part of product prodid. 

Error in file fn ft fm. data is invalid for tag tag. 

Error in file fn ft fm. There are no elements. 

Error in file fn ft fm. The name tag is missing. 

Error in file fn ft fm. REPLACE tag missing after the element name. 

Error in file fn ft fm. parm is an invalid parameter. Expecting parameter(s) PRODID, 
PREREQ, COREQ, SUP, APARTEXT, or CHANGES. 

Invalid entry found at line /ine in fn ft. 

File fn ft [fm] [from name] not found on any DELTA disks from the VMFPARM file. 
PTF name is not a part of product prodid and must be action in product prodid. 
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DMSWMGS8S86E __ Filename name from the fn ft [/m] file is longer than 8 characters. 
DMSWMG892E PTF name has not been action. 

DMSWMG893E Incomplete processing, not all [required] PTFs were action. 
DMSWMG893W Incomplete processing, not all [required] PTFs were action. 
DMSWMG898E VMFREMOV processing is incomplete. 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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VMFNLS EXEC 


The VMFNLS EXEC procedure updates national language-related files. VMFNLS automatically applies 
updates to source files, generates text files, and renames them so they can be loaded into the system. If you 
have your own language files, this EXEC is provided so that you can maintain those files. 


Format 


The format of the VMFNLS EXEC is: 


VMFNLS fn ft — ens [(options... [)]] 


ctlfile 


options: 


PPF} | SETUP KEEPSRC 
CTL} |NOSETUP NOKEEPSRC 


Where: 
fn 


is the filename of the source file that is to be converted to text. 


ft 
is the filetype of the source file that is to be converted to text. Only ASSEMBLE, REPOS, and DLCS 
filetypes are allowed. 


ppfname 
is the filename of either the base product parameter file (which is the product identification number, 


prodid) or a product parameter override file containing an override area for the component. The filetype 
must be $PPF. 


compname 
is the name of either a base component area (which is a base component name, such as CP or CMS) or a 
component override area containing alternative or additional parameters (or both) for the component. If 
you do not specify a valid name, VMFNLS shows you a list of names and asks you to enter one. 


ctifile 
is the filename of the control file that is used to apply updates to the source file before text is generated. 
The filetype must be CNTRL. The IBM-supplied control files are described in Chapter 7, “How 
VM/XA System Product Uses Control Files and Update Files” on page 361. 


options: 


PPF 
indicates that the third operand in the command is the name of a product parameter file or override 
file that specifies the minidisk/directory search order and the name of the control file. 


CTL 
indicates that the third operand in the command is the name of a control file. If CTL is specified, 
the product parameter file is not used. 


If neither CTL nor PPF is specified, VMFNLS searches for a file whose name matches the third 
operand in the command. If a file with that name is located, VMFNLS checks the filetype to 
determine if the file is product parameter file ($PPF) or a control file (CNTRL). If both files exist, 
the product parameter file is used. 
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SETUP 
sets up a minidisk/directory access order for the assemble function. This option is valid only when 
using a product parameter file. 


NOSETUP 
does not set up a new access order. 


KEEPSRC 
indicates that the merged source file consisting of the updates and the base source file will be saved 
on the user’s disk. The file is named $filename filetype, where filename is the original source input 
filename and filetype is the original source input filetype. 


NOKEEPSRC 
does not save the merged source file. 


Note: In addition to the options described above, VMFNLS accepts certain options for three of the 
commands that it issues: 


e ASSEMBLE 
¢ GENMSG 
¢ CONVERT COMMANDS. 


Some options are assigned by VMFNLS; other options that can be used depend on the filetype of the 
source file. See the following section, “How VMFNLS Works.” For complete descriptions of these 
commands and their options, see V4/XA SP CMS Command Reference. 


How VMFNLS Works 


1. If a product parameter file is being used: 


a. VMFNLS calls the VMFOVER EXEC to build a temporary product parameter file (filetype 
SPPFTEMP) containing the parameters for the component being processed. 


b. If a user EXEC is specified in the USEREXIT tag in the $PPFTEMP file, VMFNLS calls the user 
EXEC with the parameters VMFNLS and SET-UP. 


c. If the NOSETUP option is not specified, VMFNLS calls the VMFSETUP EXEC with the ACCESS 
ASM options to save the current minidisk/directory access order and build a new one for the 
assemble function using data from the $PPFTEMP file. 


2. VMFNLS issues the UPDATE command with the CTL, STK, PRINT, and OUTMODE Al options. 


UPDATE uses the control file (ctifile CNTRL) specified in the product parameter file or in the 
VMFNLS command to update the assembler language source file. 


UPDATE stacks information from the control file in the console stack and prints the update log file. 


The OUTMODE Al option specifies that the files created by the UPDATE command are written on 
filemode A with a filemode number of | (Al). 


If a PTF file is missing, UPDATE writes a message to the console and to the update log file. 
3. At this point, processing depends on the filetype of the input source file: 
e If the source file is an ASSEMBLE file: 


a. Using the library list from the MACS records in the control file) VMFNLS issues a GLOBAL 
MACLIB command. 


b. VMFNLS issues the ASSEMBLE command to assemble the updated source file. 
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e If the source file is a REPOS (message repository) file: 
a. VMFNLS determines the /angid associated with the source file: 


— Ifthe source filename is only 6 characters, VMFNLS assigns AMENG (American English) 
as the default langid. 


— If the source filename is longer than 6 characters, VMFNLS extracts the country code from 
the seventh and eighth characters of the filename and searches the VMUFNLS LANGLIST 
file to find the corresponding langid. This file contains a list of all valid country codes, along 
with the associated /angids and language names, as shown in Figure 52. 


American English 
Kanji 
Uppercase English 


Brazilian Portuguese 
French 
German 


Figure 52. VMFNLS LANGLIST File 


If the country code from the source filename is not contained in the VMFNLS LANGLIST 
file, all temporary files are erased, the printer is closed, and VMFNLS terminates. 


b. VMFNLS issues the GENMSG command to compile the input REPOS file and produce a text 
filee VMFNLS sets up the operands for GENMSG as follows: 


jn 
is the filename of the file to be compiled. GENMSG places this name in the ESD card when 
the text file is produced. The possible filenames are: 


jn Repository 
HCPMES CP 
DMSMES CMS 
CSIMES GCS 


is REPOS, the filetype of the repository file to be compiled. 


applid 
corresponds to the first three characters of the filename of the source file: 
applid Application 
HCP CP 
DMS CMS 
CSI GCS 
langid 


is the language identifier of the source file. 


options 
depend on the component associated with the source file. For the CP repository, VMFNLS 
uses the GENMSG options CP MARGIN 63. For other components, VMFNLS uses the 
GENMSG option MARGIN 63. 


Note: For a Kanji CP repository, VMFNLS uses the GENMSG options CP DBCS. For 
other Kanji repositories, VMFNLS uses the GENMSG option DBCS. 


Other GENMSG options can be specified with the VMFNLS command if they do not 
conflict with the GENMSG options assigned by VMFNLS. 
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GENMSG produces a text file that has the same filename as the input file and a filetype of 
TEXT. GENMSG also produces a LISTING file, whose filename is the source file’s filename 
with a prefixed dollar sign. 


The following table shows some examples of the text and listing files written to filemode A from 
a given message repository source file: 


Source File Text File Listing File 

HCPMES REPOS HCPMES $HCPMES LISTING 
{TEXT|TXTrannn} 

DMSMESA REPOS DMSMESA $DMSMESA LISTING 
{TEXT|TXTannnn} 

CSIMESB REPOS CSIMESB SCSIMESB LISTING 
{TEXT|TXTnnnnn} 


Note: mnnnn is the number of the most recently applied PTF. 


The updated source file is then printed. 


For a complete description of the GENMSG command, see VM/XA SP CMS Command 
Reference. 


e If the source file is a DLCS (definition language for command syntax) file) VMFNLS issues the 
CONVERT COMMANDS command to produce two text files from the input file. 


VMENLS sets up the operands for CONVERT COMMANDS as follows: 
fn 


is the filename of the file to be compiled. 


ft 
is the filetype of the file to be compiled. 


fm 


is always set to *. 


options 

are not assigned by VMFNLS; any valid CONVERT COMMANDS options can be specified. 
The filenames of the text decks produced by CONVERT COMMANDS depend on the DLCS 
statement contained in the input file. This statement identifies the applid, langid, and whether the 


input file is a user or system DLCS file. CONVERT COMMANDS uses the /angid to obtain the 
corresponding country code (y) from the VMFNLS LANGLIST file. 


For a system DLCS file, the filenames of the text decks are applid SPAy for the command syntax 
definition file and applid SSYy for the translation and synonym table. For a user DLCS file, the 
filenames of the text decks are applid UPAy for the command syntax definition file and applid USYy 
for the translation and synonym table. 


The filetype of the output text files is TEXT. 
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The following table shows some examples of the text files produced from a given source file: 


Source File Text Files 
DMSSPA DLCS DMSSPA TEXT 
DMSSSY TEXT 
DMSSPAB DLCS DMSSPAB TEXT 
DMSSSYB TEXT 
DMSSPAC DLSC DMSSPAC TEXT 
DMSSSYC TEXT 


The updated source file is then printed. 


For a complete description of the CONVERT COMMANDS command, see the VM/XA SP CMS 
Command Reference. 


4. Each output TEXT file from the ASSEMBLE, GENMSG, or CONVERT COMMANDS processing is 
concatenated with the UPDATES file so that the TEXT file contains a history of update activity. 


5. VMFNLS renames the TEXT file as follows: 


e If the PPF option is specified and no PTF prefix is found in the control file, the TEXT file is 
renamed fn TXTnnnnn, where nnnnn is the PTF number obtained from last AUX file entry processed 
by the UPDATE command. If a PTF prefix is found in the control file, that prefix overrides the 
TXT default. . 


e Ifthe CTL option is used, VMFNLS uses the update level identifier from the control file (the 
identifier of the most recent update that was found and applied is stacked by the UPDATE 
command), to rename the TEXT file. If the update level identifier is anything other than TEXT, the 
TEXT file is renamed fn TXTnnnnn (where nnnnn is the 1- to 5-character update level identifier). 


The new fn TXTnnnnn or fn TEXT file is found on filemode A. 


Note: The new text deck will be filemode Al regardless of the filemode of the original text deck. If the 
filemode number of the original text deck is anything other than 1, you must rename the text deck 
created by VMFNLS. 


6. If a product parameter file is being used: 
a. VMFNLS calls VMFSETUP to restore the original minidisk/directory access order. 


b. If a user EXEC is specified in the USEREXIT tag in the $PPFTEMP file, VMFNLS calls the user 
EXEC with the parameters VMFNLS, CLEAN-UP, and a return code. 


DMSWNLOOIE No filename specified. 

DMSWNL002E #$VMENLS LANGLIST * not found. 

DMSWNLO023E _iNo filetype specified. 

DMSWNLO32E Invalid filetype /t. 

DMSWNL122E _ Return code rc from routine. 

DMSWNL179E Missing or invalid MACS card in control file fn ft f/m. 
DMSWNL328E Control file not specified. 

DMSWNL448E —s_ Country code code not in list. 


For a complete explanation of each message, see VM/XA SP System Messages and Codes Reference. 
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VMFOVER EXEC 


The VMFOVER EXEC makes a temporary copy of one component section from the product parameter file 
with changes made in accordance with the override section of the product parameter file or a separate PPF 
override file. The other service and installation EXECs use this copy instead of the base product parameter 
file. 


VMFREC, VMFAPPLY, VMFHASM, and VMFBLD all issue VMFOVER automatically. You can also 
issue VMFOVER from the command line if you want to see the temporary product parameter file. 


Format 


The format of the VMFOVER EXEC is: 


VMFOVER prodid compname 


Where: 


prodid : 
is the product identifier of the product to be serviced. For VM/XA System Product Release 2.1, the 
product identifier is 56643089. 


compname 
is the component to be serviced, for example, CP or CMS. compname can be a name listed after the 
:COMPLST. tag or the :OVERLST. tag in the base PPF; or after the ;OVERLST. tag in the PPF 
override file. If you do not specify the compname, you will be shown a list of components and asked to 
choose one. 


How VMFOVER Works 


VMFOVER locates the file with a filename of prodid and a filetype of $PPF. This file can be either a base 
PPF or a PPF override file. The EXEC then checks the list of component names following the :COMPLST. 
tag for the component name you specified. If the name is found, this is the base product parameter file. The 
appropriate component section is copied to a file called prodid SPPFTEMP, and processing stops. 


If the component name is not listed after the :COMPLST. tag, VMFOVER looks for it after the ;OVERLST. 
tag. If the component name is not listed there, VMFOVER issues an error message. 


If the component name is found after the :OVERLST. tag, VMFOVER looks for a :compname. tag. The 
:compname. tag tells VMFOVER where to look for the basic information about the component. For 
example: 


sCP. CP 56643089 
sCORCP. CP 


The first example is from an override file. It tells VMFOVER that the basic information about CP is found 
in the CP section of 56643089 $PPF. The second example is from the override section of a base PPF. Notice 
that it does not specify a filename. It tells VMFOVER to look for the base information about CORCP in 
the CP section of this file. 
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Override information follows the :compname. tag. VMFOVER combines the override information with the 
base information to create a copy of the appropriate component section of the product parameter file. The 
filename of the copy is the filename of the override file if the NEWNAME option was specified on the 
:compname. tag in the override file; otherwise, it is the filename of the base PPF. The filetype of the copy is 
SPPFTEMP. 


The NEWNAME option on the :compname. tag is reserved for creating a test or sample override file 
executing VMFOVER from the command line. For any other execution, the filename of the temporary 
product parameter file must match the prodid or product identifier of the product on the tape to be serviced 
and NEWNAME should not be specified. 


For examples of a base product parameter file with an override section, an override file, and SPPFTEMP 
files, see Chapter 8, “Files Used in PUT and COR Service.” 
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VMFPLC EXEC 


VMFPLC is a common EXEC which calls either VMFPLC2 or VMFPLCD. VMFPLC supports the 
VMFPLC2 and VMFPLCD command formats. A ROUTE function allows VMFPLC to establish command 
routing for subsequent VMFPLC2 or VMFPLCD commands issued by VMFPLC. 


VMFPLC acts as a front-end processor to minimize changes to existing routines which use VMFPLC2 when 
conversion to VMFPLCD or a dual path is desired. It allows either command format to be used including a 
mixture of the two sets of functions, and parameters and options. 


Format 


The format of the VMFPLC EXEC is: 


VMFPLC ROUTE options: 


command string for VMFPLC2 or VMFPLCD 


options: 


DISK [fn ft fm] 
TAPE 


Where: 


ROUTE 
is not passed to VMFPLC2 OR VMFPLCD. It is used to establish the routing for subsequent 
commands issued to VMFPLC which are to be passed to VMFPLC2 or VMFPLCD, or to reset any 
previous routing established. 


If ROUTE is not specified, it is assumed that you are entering a VMFPLC2 or VMFPLCD command 
string. 
If no option (DISK or TAPE) is specified with the ROUTE operand, ROUTE resets the routing variable 
to TAPE, regardless of any previous setting. 

options: 


DISK [fn ft fm] 
establishes routing to disk (VMFPLCD). If the routing is to disk, the file ID of the envelope may 
also be established (optional). If the envelope file ID is provided, it must be the complete file ID of 
jn ft fm. The file ID is checked for validity only to the extent that there are three parameters. 


TAPE 
establishes routing to tape (VMFPLC2). 
Usage Notes 


1. When you issue VMFPLC, and not VMFPLC2 or VMFPLCD directly, VMFPLC will route to 
VMFPLC2 or VMFPLCD according to the routing in the VMFPLC GLOBALYV variable from a 
VMFPLC ROUTE command. If there is no routing established, the default routing is VMFPLC2. 
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2. Once the command routing has been determined, the options and control functions will be converted (if 
necessary) to those appropriate for the chosen routing as follows: 


a. Options WIM, NOWTM, EOT and EOF from VMFPLC2, and WGS, NOWGS, EOD and EOG 
from VMFPLCD will be converted to the respective keyword for the command to be called. 


VMFPLC2 options TAPn, CUU (device address), TRTCH a DEN den and nnTRACK will be 
deleted if the routing 1s to VMFPLCD. 


b. The control functions will be converted as follows: 


VMFPLC2 VMFPLCD 

MODESET No equivalent (See Note 1) 
ERG No equivalent (See Note 1) 
B/FSR No equivalent (See Note 2) 
B/FSF B/FSG 

REW RST 

RUN RST (See Note 3) 
WTM WGS 

Notes: 


1) VMFPLC2 MODESET and ERG functions have no equivalent function in VMFPLCD and will 
be handled as a “no operation” request by VMFPLC if the command is for disk. For example, a 
return code of zero will be passed back without calling VMFPLCD. 


2) VMFPLC2 BSR and FSR have no equivalent function in VMFPLCD. The functions will be 
passed unchanged to VMFPLCD (if the medium is DISK) resulting in an error because these 
functions are supposed to alter the position within the tape or envelope and no position change 
occurs. 


3) VMFPLC2 REW and RUN functions both convert to a VMFPLCD RST function. The 
VMFPLCD RST function converts to the VMFPLC2 REW function, not the RUN function. 


3. VMFPLC will not check command syntax or option validity. With the exception of the previous 
keyword/command handling, the command will be passed intact. Thus, all errors are issued by 
VMFPLC2 or VMFPLCD. 


4. If the envelope file ID is provided with the DISK option, it is used to set or reset the GLOBALV 
variable used by VMFPLCD to remember the file ID across multiple invocations. If the file ID is 
different from that in an existing GLOBALYV, or there is no existing GLOBALYV, the logical record 
position in the envelope is set to record 1. If the GLOBALV variable exists and the file ID on the 
ROUTE function is the same as in the GLOBALYV, no change in the logical record pointer is made. 


5. Routing information is maintained in a GLOBALV variable for VMFPLC across multiple invocations of 
VMFPLC. The GLOBALYV variable is maintained only within a CMS IPL; it is reset automatically on 
IPL. If ROUTE is issued with no parameters, the VMFPLC GLOBALYV routing variable is deleted. 
This does not reset the file ID for the envelope file used by VMFPLCD. 


Messages and Return Codes 


DMSWPCO003E Invalid option option [RC =24] 
DMSWPCI1447E Invalid command format [RC =24] 


Note: Any other messages you may receive are returned from the VMFPLC2 EXEC or VMFPLCD EXEC. 
See the VMFPLC2 EXEC or VMFPLCD EXEC descriptions for an explanation of these messages. 
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VMFPLCD EXEC 


Use the VMFPLCD EXEC to: 
e Load files from the envelope file 


¢ Dump CMS files to the envelope file (files to be dumped can contain either fixed-length or 
variable-length records) 


¢ Load previously dumped files from the envelope file 
¢ Do various control operations on the envelope file. 
Note: Files processed by the VMFPLCD EXEC must be CMS-formatted. 


Format 


The format of the VMFPLCD EXEC is: 


VMFPLCD 7 ~ porte 
A areiell 


ie envid | (optionB 
optionCc) 
optionD) 
optionE) 


(optionB ] 


envid | optionc) 


optionE) 


envid | (optionB 
optionc) 


optionE) 
ctlcmd 


envid = 


sail | 


optionB: 


EOD 
optionc: Ee n 
Ee E0G 1 


optiono: [sELect | [stop] 


optione: [ DATE] 
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Where: 


DUMP 
dumps one or more CMS files to an envelope file. You must specify a fnJ and ftl; fml is optional. They 
may be specified using “wild card” characters, as described in the “Usage Notes” number 12. _ 


If you specify fmJ as a letter, that filemode and its extensions are searched for the specified files. If you 
specify fm/ as a letter and number, only files with that filemode number on that filemode and its 
extensions are dumped. If you use wild card substitution, specifying fmJ as an asterisk (*), all filemodes 
are searched for the specified files. If you do not specify the fmJ, only filemode A and its extensions are 
searched. 


The envelope file that is to receive the dumped file is identified by the ENV= fn2 ft2 fm2 parameters. 
See the “Usage Notes” for a description of the default assignment if the ENV = parameter is not 
supplied. The fm2 must be for a disk accessed in write mode. 


Note: The envelope file may not be dumped to itself. See “Usage Notes” for a more detailed 
description. 


LOAD 
copies the specified files contained in an envelope file created by DUMP into separate disk files with the 
file identifier of the original files. The envelope file ID is identified by the ENV= fn2 ft2 fm2 parameter. 


You may specify fni and ft] with wild card characters as described in the “Usage Notes.” 


Note: No file may be loaded from the envelope which would overlay the envelope. See the “Usage 
Notes” for a complete description. 


Option C (EOG or EOD) controls the limit of the search in the envelope file for a disk file to be loaded. 


If a file identifier (fn/ ft/) for the file to be loaded is specified, only that one file is copied from the 
envelope file. If no file identifier is specified, all files within the n file groups from the option EOG n (or 
in the entire envelope file for option EOD) are copied. The fri and ft] may be specified using wild card 
substitution characters. If wild card substitution is used, then any file in the envelope that satisfies the 
Jnl ftl specified will be loaded within the limits set by options EOG n or EOD. See the description for 
wild card specification in the “Usage Notes.” 


The files are written to the disk identified by the filemode letter. This disk must be accessed as read-write 
mode. Ifa filemode number is specified, only files with that filemode number are loaded. The default 
filemode is A. 


SCAN 
positions the envelope file at a specified point and lists the identifiers of the files within the envelope file 
scanned. Scanning occurs over n file groups, as specified by the option EOG n (the default is 1) or over 
the entire envelope file (EOD option). 


If a specific disk file identifier (fn/ ftJ) is specified, scanning stops upon encountering that file. The 
position within the envelope file is set to the header record of the file which satisfies the file identifier. 


The fni and ft/ may be specified using wild card substitution characters. See the “Usage Notes” for 
details. If wild card substitution symbols are used, the file identifier is not used to locate a specific file on 
which to stop the scan for positioning. Instead, the file identifier is used only to determine which files 
will be logged. 


If fnl and ft! are not provided, all files encountered are logged if logging is requested. 


SKIP 
positions the envelope file at a specified point and lists the identifiers of the files within the envelope file 
skipped. Skipping occurs over n file groups, as specified by the option EOG n (the default is 1 file group) 
or over the entire envelope file (EOD option). | 


If a specific disk file identifier ({n/ ft/) is specified, skipping stops upon encountering that file. The 
position within the envelope file is set to the header record of the next file, or the group separator record, 
whichever follows. 
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The fnJ and fti may be specified using wild card substitution characters. If wild card substitution 
symbols are used, the file identifier is not used to locate a specific file on which to stop the scan for 
positioning. Instead the file identifier is used only to determine which files will be logged. See the 
“Usage Notes” for a description of wild card substitution. 


If fnl and ft] are not provided, all files encountered are logged if logging is requested. 


ctlemd : 
provides logical positioning and file group separation functions for the envelope file. 


The functions are: 

tapcmd _ Action 

BSG Backspace n file group separators 
FSG Forward space n file group separators 
WGS Write n file group separators 


RST Reset logical position to start of the file envelope file, and reset the file ID of the envelope 
file. 


ENV = 
The ENV= parameter represents the envelope file that is to be processed. The envelope is represented as 
Jn2 ft2 fm2. See the “Usage Notes” for a description of the default assignment if the ENV= parameter 
is not specified. fm2 must be for a disk accessed in write mode. 


optionA: 


WGS 
writes a file group separator after each file is dumped. 


NOWGS 
indicates that no group separator is written after each file is dumped. NOWGS is the default. 


optionB: 
NOPRint 
does not list the files dumped, loaded, scanned or skipped. 
PRint 
spools the list of files dumped, loaded, scanned, or skipped to the printer. 


Term 
displays a list of files dumped, loaded, scanned, or skipped at the terminal. TERM is the default. 


DISK 
creates a CMS file called DISK MAP AS containing the list of files dumped, loaded, scanned, or 
skipped. 


APPend 
causes the disk file containing the list of files dumped loaded, scanned, or skipped to be added to the 
end of an existing list file DISK. MAP AS). 


optionC: 
EOD 


reads the envelope file until the end-of-disk condition is recognized. End-of-disk is signaled by either 
two successive file group separators or an end-of-file condition during a read of the envelope file. 


EOG n 

EQG 1 
reads the envelope file through a maximum of n file group separators (end-of-group records). The 
default is EOG 1. 
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optionD: 


SELect 
inhibits loading of a file from the envelope file that causes replacement of an identical file in virtual 
direct access storage. Files will be loaded only if they do not exist on the disk specified by the 
LOAD command, or when the date/time stamp for the file being loaded does not match the date/time 
stamp for the existing file. 


STOP 
assumes that files contained in the envelope file are in alphabetical sequence by filename and filetype. 
If the requested file is found, the file is loaded and the envelope file is positioned at the next record 
following the loaded file. If the file is not in the envelope and a file is encountered that is 
alphabetically beyond the bounds of the requested file, no file is loaded and the envelope file is 
positioned to load this file. You must specify the disk file fnJ and ft] without using wild card 
substitution characters. If either the fn/ or the ft/ contains substitution characters, the STOP option 
will be ignored. 


optionE: 


DATE 
displays LISTFILE information during a load, scan or skip function. The information displayed 
includes the record format, logical record size, number of records, and date/time stamp. 


Usage Notes 


1. All control functions for ctlemd, except RST, allow a repetition factor (n) to be specified, to control the 
number of groups skipped or the number of group separator records to be written. The default is 1. 


2. The file ID of the envelope file is controlled by two separate factors: a GLOBALYV variable saved 
between VMFPLCD invocations, and the ENV= parameter. 


¢ Ifthe ENV= parameter is provided, it specifies a file ID for the envelope file which takes precedence 
over the other methods of specification. In this case, the fn2 and ft2 must be provided (wild card 
substitution is not allowed). The fm2 is optional, and has a default of A. 

e Ifthe ENV= parameter is not specified, the GLOBALV variable is checked to find the file ID of the 
envelope file. If present, the GLOBALV variable for the file ID will be used. This allows the first 
invocation of the command to set the file ID and all subsequent commands for the same envelope file 
to be entered without the ENV= parameter. 


Note: All functions except RST, DUMP and WGS require the envelope file to exist. If it does not, 
the function will fail and the GLOBALYV variable will not be updated with the envelope file 
ID. 


e If there is no ENV= parameter and no GLOBALV variable, an error will be returned. 


3. The GLOBALV variable is maintained for one envelope file at a time, to remember the file ID and the 
logical position across multiple invocations of VMFPLCD. When a new envelope file ID is used, the 
variable is reset automatically to the logical start of the envelope file. The variable 4s maintained only 
within a CMS IPL: It is reset automatically on each CMS IPL to null. 


4. If you wish to change the envelope file ID within the same IPL, the ENV= parameter should be used. 
Except for RST, DUMP or WGS functions, the envelope file must exist. Otherwise, the EXEC will end 
with an error, and the GLOBALYV variable will not be updated. 


5. If the prior envelope file is erased, and then a VMFPLCD command is issued with no ENV= parameter, 
the RST, DUMP or WGS commands will establish a new envelope with the same name as the prior one. 


6. If this EXEC issues an error with a return code other than 24, the GLOBALYV variable is updated. On 
input/output errors, the position is set to the last known position prior to the error. 


7. Since the end-of-disk condition is recognized as either two successive group separator records or the 
physical end of the envelope file, logical positioning functions involving the end-of-disk condition will be 
handled as if there were two group separator records at the end of the envelope file. This provides a 
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consistent external result matching VMFPLC2, regardless of what is actually present. The actual end of 
the envelope file could have no, one or two real group separators. If there are less than two real group 
separators, the required number of positions beyond the last record will be treated as group separators to 
satisfy this requirement. 


. BSG will scan the envelope backwards to locate a group separator record and will leave the position 


ready to read this group separator. FSG will scan forward to locate a group separator and leave the 
position ready to read the following record. 


. If you wish to reset the logical position to the start of the envelope file, use the RST control function. 
. The LOAD, SKIP and SCAN functions leave the position after the file or the group separator that 


satisfied the conditions specified. SCAN can also leave the position ready to read a specific file. 


DUMP and WGS leave the position ready to write at the next record position after the dumped files or 
group Separator records written as a result of the command. If the logical position at the start of a 
DUMP or WGS separator is other than the next record past the actual physical end of the envelope, then 
the envelope will be adjusted prior to the function, to either truncate it or convert the missing group 
separator records to real records. 


When specifying the {ni ft! or fm/ identifiers for the disk files, special wild card characters may be used, 
where indicated in the option and operand descriptions, to allow any characters to satisfy all or part of 
the identifier. The character * represents any number of characters including zero. As many asterisks as 
required can appear anywhere in a filename or filetype. Only one asterisk can be used for filemode. The 
character % is a place-holding character that means a single character, but any character will do. As 
many percent symbols as necessary may appear anywhere in a filename or filetype. The percent symbol 
may not be used for filemode. 


When wild card substitution is used during a DUMP function to select the files to dump, the order in 
which the files are dumped is the same order in which the files would be found with a CMS LISTFILE 
command. This order can vary from session to session. Thus, if a specific order is needed, do not use 
wild card substitution. 


The fn ft fm parameters (disk file ID or envelope file ID) must conform to CMS rules. For example, the 
filename and filetype must be eight positions and the filemode is two positions. If they are longer, they 
will be truncated to the maximum length and no error message will be issued. 


Conflicting options (for example, WGS and NOWGS) will result in an error from VMFPLCD. This is 
not treated as an error with VMFPLC2. Instead the last value entered is used. 


VMFPLCD dumps files that have a fn/ or ft] containing mixed-case characters only if wildcard symbols 
are used in the file ID. For example, the file Test FILE can be dumped with a file ID of T%%% FILE, 
* FILE, T* *, or other such IDs, but will fail if requested as Test FILE. 


If an attempt is made to dump the envelope file (or a copy of it) to itself, or if a file to be loaded from 
the envelope would overlay the envelope, processing is stopped and an error occurs. 


An envelope may contain other envelope files, but not itself. All control records within the envelope 
contain a prefix section which identifies the envelope. This prefix is established on the first output 
function performed and remains the same even if the envelope file is renamed in the middle of processing. 
Two different envelope files that were created with the same fm and ft will appear to VMFPLCD as the 
same envelope even if one is renamed after creation. 


The envelope file created by VMFPLCD is not packed to condense the size. Packing of the envelope 
prior to sending it to another user will greatly reduce the size of the file. Before processing the envelope 
again, it must be unpacked. 


The keyword ENV= must always be followed by a blank. 
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Messages and Return Codes 


DMSWPD0002E 
DMSWPD0002E 
DMSWPDO0003E 
DMSWPD0010S 
DMSWPDO01L4E 
DMSWLM6O014E 
DMSWPD0029E 
DMSWPD0040E 
DMSWPD0048E 
DMSWPD0066E 
DMSWPD6O069E 
DMSWPD01048 
DMSWPD0105S 
DMSWPDO0671E 
DMSWLM0814E 
DMSWLMO0814E 
DMSWPD1447E 
DMSWPD1448E 


DMSWPD1450S 
DMSWPD1451S 
DMSWPD1452S 
DMSWPD1453S 
DMSWPD1454S 
DMSWPD1455S 
DMSWPD1456S 
DMSWPD1457E 
DMSWPDI1458E 
DMSWPD1459S 
DMSWPD1460E 


File VMFPLCM EXEC * not found [RC = 28] 

File fn ft fm not found [RC = 20|28|36] 

Invalid option: option [RC =24] 

Premature end occurred on fn ft fm [RC =40] 

Invalid function function [RC =24] 

Invalid function function [RC =24] 

Invalid parameter parameter in the option option field [RC = 24] 

No files loaded [RC = 28] 

Invalid filemode filemode [RC =24] 

option option option option option are conflicting options [RC = 24] 
Filemode filemode not accessed [RC = 36] 

Error rc reading file fn ft fm from disk or directory [RC = 100] 

Error rc writing file fn ft fm on disk or directory [RC = 100] 

Error loading file fn ft fm; rc=rc from COPYFILE [RC= 100] 

Message number num, format fmt was not found [RC = 12] 

Dictionary number num format fmt not found [RC = 12] 

Invalid command format [RC =24] 

Option(s) option option option option option option option option option option option 
option invalid for function [RC =24] 

Output file {n ft fm disk is read-only [RC = 36] 

Cannot dump an envelope file to itself. File fn ft fm is same envelope file [RC =32] 
Unidentifiable envelope control record in fn ft fm [RC=100] 

Loading of file fn ft fm would overlay envelope [RC =32] 

Date/time stamp update on fn ft fm failed [RC = 104] 

Error occurred trying to truncate file fn ft fm [RC =100] 

Unexpected error rexx code from VMFPLCD [RC = 104] 

Envelope file was not specified [RC = 24] 

File designated as envelope on function is not an envelope [RC =32] 
Number of records for file /n ft fm different than when dumped [RC = 40] 
Envelope file fn ft exists but is on R/O extension of fm disk [RC =36] 


For a complete explanation of each message, see VM/XA SP System Messages and Codes Reference. 
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VMFPLC2 Command 


The VMFPLC2 command loads source code files from the Product Tape and loads the service installation 


EXEC (VMSERV) from the PUT. VMFPLC2 also dumps CMS files from disk to tape, loads previously 


dumped files from tape to disk, and performs various control operations on a specified tape drive. Disk files 
to be dumped can contain either fixed-length or variable-length records. 


The VMFPLC2 command does not process multivolume files. Files processed by the VMFPLC2 command 
must be in a unique CMS format. 


Format 


The format of the VMFPLC2 command is: 


VMFPLC2 


(optionA 
optionD) 
optionD 


(optionB 
optionD 


(optionB 
optionD) 


“| | 
od 8 8 ports 
| 
| 


MODESET {(optionD) } 


tapcmd k | 
1 


[(optionD)] 


optionA: |WIM 
NOWTM 


optionB: 


optionc: 


optionD: 


optionE: 


optionF: 


NOPRint 


APPend 


EOT. 
EOF n 
EOF 1 


TAPn 
cuu [DEN den] 
181 


[SELect] [STOP] 


[DATE] 
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Where: 


DUMP {fn} {ft} {fm} 
*} {*} 3 | | 
dumps one or more disk files to tape. If fn or ft is specified as an asterisk (*), all files that satisfy the 
other file identifier are dumped. 


If fm is coded as a letter, that disk and its extensions are searched for the specified files. If fm is coded as 
a letter and number, only files with that mode number and letter (and the extensions of the disk 
referenced by that fm letter) are dumped. If fm is coded as an asterisk (*), all accessed disks are searched 
for the specified files. If fm is not specified, only the A-disk and its extensions are searched. 


LOAD {fn} {ft} {fm} 
{* } {* } {A} 
reads CMS files onto disk. The optionC options control the area on the tape that the command searches. 
For instance, if EOF 1 (the default) is in effect, VMFPLC2 loads only the files specified before the first 
physical tape mark. 


If a file identifier is specified, only that one file is loaded. If an asterisk (*) is specified for fn or ft, 
VMFPLC2 loads all files that satisfy the other file identifier. 


The files are written to the disk indicated by the filemode letter. The filemode number, if entered, 
indicates that only files that have that filemode number are to be loaded. 


SCAN _ {fn} {ft} 
{* } {* } 
lists the identifiers of the files it scans. The optionC options control the area on the tape that the 
command searches. For instance, if EOF 1 (the default) is in effect, VMFPLC2 scans only the files 
specified before the first physical tape mark. However, if a file identifier (fn and /#) is specified, scanning 
stops upon encountering that file; the tape remains positioned ahead of the file. 


SKIP {fn} {ft} 
{* } {* } 
lists the identifiers of the files it skips. The optionC options control the area on the tape that the 
command searches. For instance, if EOF 1 (the default) is in effect, VMFPLC2 skips only the files 
specified before the first physical tape mark. However, if a file identifier (fn and /?) is specified, skipping 
stops after encountering that file; the tape remains positioned immediately following the file. 


MODESET : 
sets the values specified by the DEN, TRACK, and TRTCH options. After initial specification in a 
VMFPLC2 command, these values remain in effect for the virtual tape device until they are changed in a 
subsequent VMFPLC2 command, RDTAPE, WRTAPE, or TAPECTL macro. 


orn 


specifies a tape control function (tapcmd) to be executed n times (default is 1 if n is not specified). These 
functions also work on tapes in a non-CMS format. 


tapemd Action 

BSF Backspace n tape marks 

BSR Backspace m tape records 
ERG Erase gap 

FSF Forward-space n tape marks 
FSR Forward-space n tape records 
REW Rewind tape to load point 
RUN Rewind tape and unload 
WT! Write n tape marks. 
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optionA: 


WTM 
writes a tape mark on the tape after each file is dumped. 


NOWIM 
writes a tape mark after each file is dumped, then backspaces over the tape mark so that subsequent 
files written on the tape are not separated by tape marks. 


optionB: 


NOPRint 
does not spool to the printer the list of files dumped, loaded, scanned, or skipped. 


PRint 
spools to the printer the list of files dumped, loaded, scanned, or skipped. 


Term 
displays a list of files dumped, loaded, scanned, or skipped. 


DISK | 
creates a disk file containing the list of files dumped, loaded, scanned, or skipped. The disk file has 
the file identification of TAPE MAP AS. 


APPend 
causes the disk file (containing the list of files dumped, loaded, scanned, or skipped), to be added to 
the end of an existing TAPE MAP. 


optionC: 


[EOT ] 
[EOF n] 
[EOF 1] 
EOT reads the tape until an end-of-tape indication. EOF n reads the tape through a maximum of n 


tape marks. EOF 1 is the default. 
optionD: 


TAPn 
cuu 
181 


specifies the virtual device address of the tape to be read or written to; cuu is 181, 182, 183, or 184. 

The default is 181. You can also use TAPn, where n is a single digit number. The number is 

appended to the number 18 to form a device number. For instance, TAP1 becomes 181 and TAP2 

becomes 182. The unit specified by cuu must previously have been attached to your CMS virtual 
-machine before any tape I/O operation can be attempted. 


DEN den 
is the tape density, where den is 800, 1600, 6250, or 38K. 9TRACK is assumed. In the case of either 
800/1600 or 1600/6250 dual-density drives, 1600 is the default. 


optionE: 


SELect 
inhibits loading of a file from the tape in cases when VMFPLC2 would replace an identical file on 
the disk. Files will be loaded only if they do not exist on the specified disk, or when the date/time 
stamp for the file on the disk does not match the date/time stamp for the corresponding file on the 
tape. 
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STOP 
assumes that files contained on the tape are in alphabetical sequence. If the requested file is on the 
tape, the file is loaded onto disk and the tape stops. If the file is not on the tape and a file is 
encountered that is alphabetically beyond the bounds of the requested file, the tape stops. You must 
specify fn ft. Neither fm nor ft may be specified as an asterisk (*). 


optionF: 


DATE 


displays listfile information during a SCAN. The information displayed includes number of records, 
length of records, and date/time stamp. 


Usage Notes 


1. 


If conflicting options are specified on the VMFPLC2 command line, the last option entered on the 
command line is in effect. 


. The VMFPLC2 command writes tape records 4005 bytes long. The first character is a binary 2 (X'02'), 


followed by the characters CMS and a file format byte, followed by 4000 bytes of file data packed 
without regard for logical record length. If a null block is dumped, the character 0 replaces the byte after 
CMS. This causes subsequent loading of null blocks to be ignored. In the final record, the character N 
replaces the blank after CMS, and the data area contains CMS file directory information. 


. Ifa tape file contains more CMS files than would fit on a disk, the tape load operation may terminate if 


there is not enough disk space to hold the files. To prevent this, when you dump the files, separate 
logical files by tape marks, then forward space to the appropriate file. 


. The CMS file directory is the first record of each CMS file on tape. 


. It is possible to run a tape off the reel in at least one situation. If you specify EOF n and 7 is greater 


than the number of tape marks on the tape, the tape will run off the reel. 


. For more information on tape file handling, see VM/XA SP Real System Operation. 
. Do not use TAPE as a synonym of VMFPLC2, or vice versa. If you do, do not use these synonyms to 


call either function from within another EXEC. You may use any other valid synonym (for example, 
TAP). 
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Use the VMFREC EXEC to map a service tape and receive service files. 
Format 


The format of the VMFREC EXEC is: 


INFO) 8=6 CENV fn [ft [Cfm))] (L(optionA (option [)]] 
ppfname (compname] [ENV fn [ft {fm]]] 


prodid [cmpname] [ product-exec-parometers ] } optionB 
LIST fn ft 


optionA: Ed optionB: EF ie iy 
SDMAP NOLOG_} LNOSETUP_} LCOR 


Where: 


INFO 
processes the first two tape files using the default operand MEMOS. This operand creates a service 
diskmap for the volume mounted, if it does not already exist. 


ENV fn [ft[fn]] 
if specified, indicates that the PTF medium will be an envelope. A filename must be specified with it. If 
a filetype is not specified, the default filetype SERVLINK will be used. Ifa filemode is not specified, 
then the first occurrence of the filename and filetype specified will be used. 


If a filemode is specified, a LISTFILE is executed for the envelope. If the envelope is found, then 
VMFPLC ROUTE is executed so that all subsequent VMFPLC commands will be routed to the 
envelope. This allows the syntax of all VMFPLC commands in VMFREC and its part-specific EXECs 
to remain unchanged, except to call VMFPLC instead of VMFPLC2. 


If a filemode is not specified, then LISTFILE is executed. If no occurrence of the envelope is found, an 
error message is issued. If LISTFILE locates an envelope, then the filemode of this envelope is saved 
and VMFPLC ROUTE is executed for that envelope. 


After a valid envelope has been located and VMFPLC has been routed, a variable is set that contains the 
disk address of the envelope. 


If ENV is not specifed, the TAPE option of VMFPLC ROUTE is executed. 


After VMFREC calls VMFSETUP to perform accesses according to the PPF, a check is made to verify 
that the envelope is still located at the same filemode indicated by the previous VMFPLC ROUTE 
command. If the mode of the envelope disk was changed by VMFSETUP, VMFPLC ROUTE is 
executed, indicating the new filemode of the envelope. When VMFREC calls VMFSETUP to restore the 
disk setup, the check for the envelope location is again made and another VMFPLC ROUTE is issued if 
required. 


Note: The PTF envelope must be on a disk that is accessed at the start of VMFREC. This disk must 
remain accessed during VMFREC processing. This means that the address of the disk containing 
the PTF envelope must be the A-disk or be listed on the SYSTEM string for the component being 
received in the product parameter file. If the filemode of the disk containing the PTF envelope is 
changed due to internal VMFREC disk access processing, a new VMFPLC ROUTE command 
will be issued so that the PTF envelope location remains known to VMFREC. In the same 
manner, if after VMFREC processing the restoration of the original disk access order results in a 
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change of filemode for the PTF envelope disk, another VMFPLC ROUTE command will be 
issued for the envelope at its new filemode. 


ppfname 
is the filename of the base product parameter file (which is the product identification number, prodid) or 


the filename of a product parameter override file. The filetype must be $PPF. 


compname 
is the name of the component. 


For a product that uses a product parameter file, this could be the name of a base component (such as 
CP or CMS) or the name of a component parameter override area containing alternative or additional 
parameters for the component. If you do not specify a valid component or override name, VMFREC 
shows you a list of names and asks you to choose one. You can specify only one name. 


prodid 
is the product identification number of a product that does not use a product parameter file. It is also 
the filename of the product-specific exec. The filetype must be EXEC. 


product-exec-parameters 
are parameters that you want to pass to the product-specific exec. 


LIST fn ft 
specifies the filename and filetype of a list of products or components (or both) that you want to service. 
Each entry in the list must use one of the following formats: 


ppfname [compname] 
prodid [compname] [product-exec-parameters | 
Any options that you want to use must be entered on the VMFREC command, not inside the list itself. 
Note: Options must apply to all products or components (or both) in the list. 
optionA: 


MEMOS 
transfers the tape descriptor file, the tape document, memos, and crilnnf files to your C-disk if it is 
accessed, otherwise it transfers them to your A-disk. MEMOS is the default option for INFO. 


SDMAP 
transfers the tape descriptor file. 
optionB: 
LOG 
writes VMFREC messages into a receive exception log (SVMFREC $ERRLOG). . 


Note: Messages issued by the VMFOVER EXEC (called by VMFREC) are not written into the log 
but are displayed at the terminal only. 


NOLOG 
displays VMFREC messages at the terminal only. 


SETUP 
sets up a minidisk/directory access order for the receive function according to entries in the MDA 
section of the product parameter file. 


NOSETUP 
does not set up a new access order. 


Note: The SETUP/NOSETUP options are ignored with the INFO operand or to process products 
that do not use a product parameter file. 


PUT 
loads the files from a program update tape, if it is mounted. 
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COR 
loads the files from a corrective service tape, if it is mounted. 


How VMFREC Works 


The following list summarizes VMFREC processing: 


e INFO is used to selectively load tape files 1 and 2. When called with the INFO operand with the default 
option MEMOS, VMFREC does the following: 


1. VMFREC creates the tape map on filemode C (if it exists), or on filemode A. 

2. If a new service diskmap needs to be created, VMFREC loads the crilnnf files. 

3. VMFREC creates or appends to the service diskmap for this volume. 

4. Loads the documentation CMS files from tape files 1 and 2 to filemode C (if it exists) or filemode A. 
¢ When called with the SDMAP option: 


— Since the purpose of this option is to create the service disk map, the steps for this option are already 
done at the beginning of VMFREC processing. 


¢ When called with a ppfname or a prodid, either directly or through the LIST option, if the service tape 
has not been mapped, VMFREC maps the tape and loads the service documentation. Then VMFREC 
does the following processing for the specified ppfname or prodid (or, if the LIST option is used, for each 
product or component in the list): 


1. VMFREC determines if the product or component uses a product parameter file by looking at the 
filetype of the level identifier (located in the second tape file): 


— If the filetype is crilnn1, the product or component uses a product parameter file. The rest of 
this section describes the processing for products and components that use a product parameter 
file. 


— If the filetype is anything else, the product or component uses a product-specific EXEC. 
VMFREC does steps 5 and 6, then calls the product-specific EXEC and passes any parameters 
entered with the command. For more information about product-specific EXEC processing, see 
the product documentation. 


2. VMFREC calls the VMFOVER EXEC to build a temporary product parameter file (filetype 
$SPPFTEMP) containing the parameters for the component being processed. 


3. If a user EXEC is specified in the USEREXIT tag in the $PPFTEMP file, VMFREC calls the user 
EXEC with the SETUP parameter. 


4. If the NOSETUP option is not specified, VMFREC calls the VMFSETUP EXEC with the ACCESS 
REC options to save the current minidisk or directory access order and build a new one for the 
receive function using data from the S$PPFTEMP file. The access order is: 


TASK 
APPLY 
DELTA 
BASE 
BUILD 
SYSTEM. 


5. VMFREC checks the PUT or COR option specified with the command (PUT is the default) against 
the tape descriptor file (located in the first tape file) to make sure that the correct tape is mounted for 
the type of receive you want to do. 


6. VMFREC positions the tape to the files for the specified product or component. 
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7. VMFREC does merge processing as follows: 


a. VMFREC locates the MERGE tag in the $PPFTEMP file. The MERGE tag might list one or 
more names of minidisk/directory strings, such as DELTAI or LOCALI. 


b. VMFREC then locates the record for the first string name in the MDA section of the 
$PPFTEMP file. This record lists the minidisks or directories in the string in search order from 
highest to lowest, left to right. 


c. Beginning with the lowest search order pair in the string (the last two minidisks or directories 
listed on the right), VMFREC: 


1) Calis the COPYFILE command with the REPLACE option to copy all the files from the 
higher of the pair in the search order to the lower. 


2) Erases the higher of the pair. 


3) Selects a new pair consisting of the higher of the previous pair and the next higher in the 
string. 
4) Repeats the above steps for the new pair. 


5) Continues selecting pairs until the highest minidisk or directory in the string has been 
merged. This results in an empty minidisk or directory at the highest level. 


d. VMFREC looks at the next string name (if any) in the MERGE record and repeats the merge 
processing for that string. 


8. VMFREC calls one or more of the following part-specific EXECs to process the service tape and 
load the service files. The next tape file on the service tape contains a product contents directory 
that lists the service files. The RECSER section of the SPPFTEMP file identifies the part-specific 
EXEC that handles each type of file and specifies the target string. The MDA section of the 
$PPFTEMP file identifies the specific target minidisk or directory in the string. 


VMFRCAXL This EXEC receives the apply lists and exclude lists. 
VMFRCUPD _ This EXEC receives source update files as follows: 


a. VMFRCUPD does not load any update files from the tape if they exist on the 
target disk and the update is not an update shell. 


b. VMFRCUPD searches the other accessed minidisks and directories for files 
with the same filename and filetype as the update files that have just been 
received. 


— If it finds an update shell with the same name, VMFRCUPD erases the 
update shell, but retains the dependent information and the filemode 
number. : 


— If it finds a complete update file with the same name, VMFRCUPD erases 
the new file. 


VMFRCUPP This EXEC does the following with uppercase English HELP files: 
a. Scans the tape file in order to make a tape map. 
b. Processes each CMS file in the tape file individually. 


c. Looks for CMS files with a filetype of SPTFPART or a PTF-numbered filetype 
(which has 8 characters, the last 5 of which are whole numbers). If found, the 
target string is searched for a file with the same filename and filetype. If one is 
found, the CMS file is not loaded. Otherwise, the file is received on the target 
disk. 


d. Puts the file in uppercase using the COPYFILE command. 


694 Installation and Service 


VMFREC EXEC 


VMFRCTXT This EXEC receives text decks as follows: 


a. VMFRCTXT checks to see if a text deck with the same filename and filetype 
exists in the target string. 


— Ifa text deck with the same filename and filetype exists on a previous level 
minidisk or directory, the new deck is not received, and processing for that 
text deck ends. This prevents cumulative text decks received from a 
previous service tape from being duplicated in the database. 


— Ifa text deck with the same filename and filetype exists on the target 
minidisk or directory, the new deck is received to replace the existing text 
deck. The existing text deck is probably a text deck shell created by 
VMFREC, because only one copy of a specific text deck is shipped on the 
service tape. If the existing text deck is a full text deck because the service 
tape was received a second time or multiple service tapes were received to 
the same target, no harm is done by the overlay. 


b. VMFRCTXT checks the LTO (last text only) record in the $PPFTEMP file and 
processes the text deck as follows: 


— If LTO is set to NO, VMFRCTXT loads the text deck to the target. 


— If LTO is set to YES, VMFRCTXT compares the text deck prolog with the 
prologs of all other text decks that have the same filename and filetype 
prefix (for example, TXT). VMFRCTXT keeps the text deck with the 
latest entries and creates text deck shells for the others. If the text deck you 
receive on the tape does not include all the entries from earlier text decks, 
VMFRCTXT writes a message into the receive exception log. 


c. VMFRCTXT processes the history (prolog) section of all the text decks on the 
target minidisk or directory: 


— Ifa source update file does not exist for the text deck (because the part is 
serviced by replacement), VMFRCTXT creates an update shell on the 
APPLY minidisk or directory. 


— Ifa text deck does not exist in the target string, VMFRCTXT creates a text 
deck shell. 


VMFRCCOM This EXEC does the following: 


VMFRCAUX 


a. Scans the tape file in order to make a tape map. 
b. Processes each CMS file in the tape file individually. 


c. Looks for CMS files with a filetype of $PTFPART or a PTF-numbered filetype 
(which has 8 characters, the last 5 of which are whole numbers). If found, the 
target string is searched for a file with the same filename and filetype. If one is 
found, the CMS file is not loaded. Otherwise, the file is received on the target 
disk. 


This exec loads a tape file containing AUX files from a PUT or COR tape to the 
target disk in the $PPF. The AUX files are named according to the top (most 
recent) AUX entry in the file and the 3-character abbreviation of the AUX filetype 
if it does not already exist on the target string. For example, if the AUX file had 
the filetype AUXSP and the top entry in it contained the PTF number UV12345 in 
the third token, the new filetype of the AUX file would be AUC12345. If the file 
already exists on the target string, the file is erased. VMFRCAUX is called once 
for every tape file that specifies it as its part handler in the SPPF. 
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9. After the part-specific EXECs finish processing, control returns to VMFREC with a return code. 
10. If a user exec is specified in the USEREXIT tag in the SPPFTEMP file, VMFREC calls the user exec 
with the parameters VMFREC, CLEAN-UP, and a return code. 
Usage Notes 
1. The default for VMFREC INFO is MEMOS. 
2. If you have disks accessed as read-only that are identified on the MERGE tag, VMFREC will exit. You 
can override the MERGE tags in the PPF or access the disk as read/write to avoid this. 
Return Codes 


VMFREC issues the following return codes: 


Return Code | Explanation 


A message of type CK, WN, RO, or BD was encountered. Check 3VMFREC 
SERRLOG. 


co 
aE | ania 
oo 


There was an unexpected tag in PPF. 
The required file was not found. 
An unrecoverable error was encountered. 
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VMFREMOV EXEC 


The VMFREMOV EXEC procedure removes PTFs applied by the VMFMERGE EXEC procedure. 


Do not use this procedure to service any of the base components of VM/XA SP. Use this procedure when 
applying PTF's to System Network Architecture (SNA) products. 


Format 


The format of the VMFREMOV EXEC is: 


prodid PTF [ptfnum|*] 


PTFLIST remlist 
CONVERT [listfilemode ] 


Where: 


prodid 
is the ID of the product. 


PTF [ptfnum|*] 
removes the specified PTF (pt/num is the filename of a PTF) or, if you enter * instead of a ptfnum, 
removes the PTFs listed in a remove list file named prodid REMLIST. This file must already exist on a 
DELTA disk. 


PTFLIST remlist 
removes the selected PTFs in a remove list file named remlist REMLIST. This file must already exist on 
a DELTA disk. 


CONVERT 
invokes the tool that creates the reqby log file (if one does not already exist), but does not remove any 
changes. 


lastfilemode 
specifies the filemode of the last DELTA disk. VMFREMOV assumes that the merge disk is always 
accessed as E and that all other DELTA disks are accessed as consecutive filemodes between F and the 
lastfilemode. If you do not specify lastfilemode, then the filemodes for the MERGE and DELTA disks 
are determined from the information in the VMFPARM file. Use the /astfilemode parameter only if you 
know you have the correct disks accessed as the proper modes. 


If you wish only to create the reqby log and do not want to remove any changes, use the CONVERT 
keyword. 


Appendix B. EXEC and Command Format Summaries 697 


VMFREMOV EXEC 


How VMFREMOV Works 


VMFREMOV 1s a service process that removes PTFs applied by VMFMERGE. The EXEC procedure: 


1. 


Obtains data from the merge log and the service control files to build the reqby log if one does not 
already exist. The reqby log contains a list of all dependent PTFs that must be removed if their requisite 
PTF is removed. 


e Ifa service control file for any of the PTFs is missing, then processing continues. However, the 
reqby log will be incomplete if the missing service control file contains requisites. If any SCFs were 
missing, processing ends after VMFREMOV completes the build of the reqby log. No PTFs are 
removed. 


. Checks the merge log to insure that the PTF to be removed is currently merged. 
. Reads the reqby log for the list of dependent PTFs to remove. 
. Removes a PTF (for example, UV0@007) that may supersede other PTFs (for example, UV60G05). 


Note: The other PTF (UVG0005) is no longer superseded and its status remains as it was prior to the 
merge of the primary PTF (UVG0007) (that is, merged, superseded, or no status). If the prior status 
of UV00005 is no status, then VMFREMOV removes its dependents. 


. Copies, from the DELTA disk to the MERGE disk, each element affected by the PTF being removed if 


previous service for an element is merged. If the element has not been merged, VMFREMOV erases the 
element from the MERGE disk. 


The very first line of a copied text deck is always a comment line consisting of the PTF name, and the 
date and time stamp. Any information on the :apartext entry is copied, but the first line is a comment. 


‘Note: A temporary file (with filetype of OVMFMGLG) is created during this procedure to insure system 


integrity. This file is erased during normal VMFREMOV processing. 


. Removes the element’s entry from the reqby log. If an element has other elements that are dependent 


upon it, VMFREMOV also removes those dependent entries from the reqby log. 


. Updates the merge log with the current status of the PTFs. The merged entry is commented out. 


Another comment is added to the end of the merge log (with a time and date stamp) indicating that the 
PTF has been removed. 


In the case where a PTF that supersedes another PTF is removed, the superseded entry is commented out. 


Note: If you remove a change, VMFREMOV has no way of knowing if the change is a requisite of a change 


in another product. You should make note of any cross-product requisite information during 
VMFMERGE processing (see page 669) in order to know which changes to manually remove. 


Messages 


DMSWRMO02E _ File fn ft [f/m] not found. 

DMSWRMO002W _sFile fn ft [f/m] not found. 

DMSWRMOO8E ____ Device vdevno invalid or nonexistent. 

DMSWRMOIT7E Invalid device address vdevno. 

DMSWRMS820E Invalid operand: operand. 

DMSWRMS45E Missing operands. 

DMSWRM632E —=‘i1/O error in EXECIO; RC-nn from command command. 
DMSWRM649E _ Extraneous parameter parm. 

DMSWRM653E __ Error executing command. 

DMSWRM823E PTF name! is listed as a dependent of PTF name2, but PTF name! is not merged. 
DMSWRM824W = prodid VMFREQBY may be incomplete due to a missing SCF. 
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DMSWRM856E 


DMSWRM857E 
DMSWRMS858E 
DMSWRM859E 
DMSWRM860E 
DMSWRM8s861I 
DMSWRM862I 
DMSWRM863E 
DMSWRM864W 
DMSWRM865I 
DMSWRM866W 
DMSWRM867E 
DMSWRM874E 
DMSWRM879W 


DMSWRMS882E | 


DMSWRM883W 
DMSWRM&888E 
DMSWRM892E 
DMSWRM893W 


VMFREMOV EXEC 


Disk address vdevno is listed more than once on the DELTA and/or MERGE entry records 
in the prodid VMFPARM file. 

The number of disk addresses on the DELTA entry record cannot exceed nine. 

Unable to find a tag entry record in the fn ft file. 

The prodid VMFPARM file has no disk addresses on the {MERGE|DELTA} entry record. 
Only one {MERGE|DELTA} entry record may appear in the prodid VMFPARM file. 
Accessing disk_type disk vdevno as fm. 

Change name {has been action|is no longer SUPERSEDED by name}. 

The MERGE disk vdevno must be linked read-write. 

PTF name will not be action because it is not status. 

Processing PTF name. 

No PTEs have been action. 

Invalid status status in prodid VMFMGLOG for entry PTF. 

Invalid entry found at line /ine in fn ft. 

Change name name appears more than once in the fn /t. 

File fn ft [fm] [from name] not found on any DELTA disks from the disks from the 
VMFPARM file. 

PTF name is not a part of product prodid and must be action in product prodid. 

Error in name SCF. No entry for element fn /t. 

PTF name has not been action. 

Incomplete processing, not all [required] PTFs were action. 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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VMFSETUP EXEC 


The VMFSETUP EXEC uses the minidisk assignment section of the product parameter file to establish the 
correct minidisk access order for the component being serviced. It can also be used to release the accesses it 
established and restore the previous access order. VMFSETUP is invoked by VMFAPPLY, VMFHASM, 
and VMFBLD. You can also invoke it from the command line. 


Format 


The format of the VMFSETUP EXEC is: 


VMSETUP prodid compname [PPFTEMP] [(options... [)]] 
options: 
[ACCESS [ASM]|RESTORE] 
[APP] 
[BLD] 
[REC] 
[ALL] 


(RETAINm mm... ] 


Where: 


prodid 
is the product number of the product to be serviced. For VM/XA SP, the product identifier is 56643089. 


compname 
is the name of the component to be serviced. The names for the VM/XA System Product Release 2.1 
components are CP, CMS, GCS, and DV. 


PPFTEMP 
indicates that the caller has created a $PPFTEMP file that contains only one component (keyword). If 
not specified, VMFSETUP calls VMFOVER to create a $PPFTEMP file based on the prodid $PPF file 
and any existing override file. 


options: 


ACCESS 
indicates that a new minidisk access order should be set up. ACCESS is the default. 


Note: Ifa minidisk is in access mode read-write, and you have specified that minidisk as a read-only 
disk in your prodcct parameter file, VMFSETUP releases the minidisk and re-accesses it as a 
read-only disk. 


RESTORE 
indicates that the accesses should be released and the previous access order restored. 


REC 
sets up the access order for VMFREC. 


APP 
sets up the access order for VMFAPPLY. Whenever one of these EXECs invokes VMSETUP, it 
specifies APP. 


700 Installation and Service — 


_VMFSETUP EXEC 


ASM 
sets up the access order for VMFHASM. Whenever VMFHASM invokes VMSETUP, it specifies 
ASM. ASM is the default option. 


BLD 
sets up the access order for VMFBLD. Whenever VMFBLD invokes VMSETUP, it specifies BLD. 


ALL 
sets up all the accesses specified in the minidisk assignment section of the product parameter file. 


RETAIN m m m... 
each m indicates a filemode that is not to be used by VMFSETUP. 


How VMFSETUP Works 


If VMFSETUP is invoked from the command line rather than from another EXEC, VMFSETUP invokes 
VMFOVER. 


If the file named productid SSETUP exists, the current accesses are validated against the release section of 
productid SSETUP. If the accesses do not match, the user is notified and given the option of terminating or 
releasing everything but the A-disk. 


If the accesses match, the original accesses saved in the restore section of the file with the filename of the 
product name and a filetype of SSETUP are restored. If the RESTORE option was specified, VMFSETUP 
processing is complete. 


If the ACCESS option was specified or chosen by default, VMFSETUP locates the minidisk assignment 
section (:MDA.) in the chosen component section of the product parameter file. VMFSETUP then saves the 
current minidisk access order in the restore section of productid SSETUP. 


Minidisks are accessed according to the process options specified. Table 20 shows the minidisk access order 
for each option: 


Table 20. Minidisk Accesses Established by VMFSETUP EXEC 


Finally, VMFSETUP does a QUERY SEARCH, displays the results on the screen, and stores the results in 
the log. In addition, these new accesses are saved in the release section of the file named productid $SSETUP 
in the form needed to validate before a subsequent release. 


Note: Ifa minidisk is in access mode read-write, and you have specified that minidisk as a read-only disk in 
your prodcct parameter file, VMFSETUP releases the minidisk and re-access it as a read-only disk. 
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VMFVIEW EXEC 


The VMFVIEW EXEC invokes XEDIT to allow you to view the exception logs. Using the VMFVIEW 
EXEC’s PF key assignments, you can: 


e View all the messages of a specific type 

¢ View all the messages of a specific number 

¢ View the HELP screen for a particular message 

¢ Move backwards and forwards through. the displayed exception log. 


The PF key assignments that the VMFVIEW EXEC uses are defined in a tailorable profile called 
VMFVIEWS PROFILE. See “The VMFVIEW Profile File” on page 704for a description of this profile. 


Format 


The format of the VMFVIEW EXEC is: 


2 | errlog ({(LAST |ALL] 


errlog: 


Receive|VMFRec |$VMFRec 
Apply |VMFApply|$VMFApp 
Build |VMFBIid |$VMFBid|BLD 


Where: 
? 
causes a VMFVIEW help screen to be displayed. 


errlog 
is the exception log you want to view. Specify: 


e Receive, VMFRec, or $VMFRec to view the receive exception log 
e Apply, VMFApply, or SVMFApp to view the apply exception log 
¢ Build, VMFBid, SVMFBId, or BLD to view the build exception log. 


LAST 
specifies that only messages from the most recent run in the exception log will be displayed. LAST is the 
default for VMFVIEW. 


ALL 
specifies that messages from all runs in the exception log will be displayed. 
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Default PF Key Assignments 


The default PF keys for the VMFVIEW EXEC are: 


PFO01/13 - Help Display a HELP screen (see Usage Note 3) 
PFO2/14 - All Display ALL messages (see Usage Note 4) 
PF03/15 - Quit Exit VMFVIEW 

PF04/16 - Exception Display CK:, MS:, RQ:, SV:, and WN: messages 
PFO5/17 - Status Display ST: messages 

PF06/18 - Build Display BD: messages 

PF07/19 - Backward Display previous screen of messages 
PF08/20 - Forward Display following screen of messages 
PF09/21 - OutCompRq Display RO: messages 

PF10/22 - Non-Stat Display all messages except ST: messages 
PF11/23 - Requisite Display RQ: messages 

PF12/24 - Severe Display SV: messages. 


Message Headers 


The message headers that appear in the exception logs are: 


BD These are “build” messages that give information needed to rebuild the parts affected by the application 
of service. 


CK These are items that you must check. These messages contain information that may require user action. 


MS These are “mismatch” messages that indicate conflicting control information that must be investigated 
and corrected. | 


RO These are “requisite out of component” messages. They indicate that PTFs must be applied to another 
component. | 


RQ These are “requisite” messages that indicate that there are PTFs (in the same component) that are 
missing and must be applied. 


ST These are “status” messages. These message give useful information but require no further action. 


SV These are “severe” messages. These indicate problems that resulted in the termination of a process. 
These problems must be investigated and corrected. 


WN These are “warning” messages that must be investigated. They indicate situations that may or may not 
be a real problem. It is up to the user to decide after investigating the cause of the message. 
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Usage Notes: 


1. PF keys are defined by the file VMUFVIEWS PROFILE. You can change the PF key assignments by 
editing this file. Instructions for tailoring the PF keys appear at the beginning of this file. 


2. The initial set of exception log messages displayed by VMF VIEW is defined in the file VMFVIEWS 
PROFILE. The default is the “exception” category of messages. 


3. The Help PF key performs one of two functions, depending on the position of the cursor: 


a. When the cursor is on the command line or on a line with no message number, the VMFVIEW help 
screen will be displayed 


b. When the cursor is on a line that contains a message number, the help screen for the corresponding 
CMS message number will be displayed. If the requested help screen cannot be found, a message is 
displayed. 


4. The “All” PF key performs one of two functions, depending on the position of the cursor: 


a. When the cursor is on the command line or on a line with no message number, the “All” key causes 
all of the messages in the log to be displayed 


b. When the cursor is on a line that contains a message number, the “All” key causes all of the 
messages in the log with this message number to be displayed. Note that these keys are still qualified 
by the LAST|ALL command line option of VMFVIEW. 


5. To gather information about messages, you can issue commands such as FILELIST and XEDIT from 
the command line. 


6. You may find it useful to put a subset of messages into a separate CMS file. To do this you can use the 
XEDIT PUT command. An example follows: 


If you want to put all BD: (build) messages in a file to process separately, press the appropriate PF key 
to isolate this subset of messages. (The default is PF06/18.) Then enter the following command on the 
XEDIT command line: 


PUT * BUILD 
This creates a CMS file with the name BUILD $ERRLOG. The PUT command changes the current line 


on the XEDIT screen. You can enter TOP on the XEDIT command line line to make the current line the 
top line of the file or press another PF key to view a new subset of messages. 


7. You may find it useful to add the invocation of VMFVIEW to the service user exits. To do this, include 
the following commands in your user exit: 


parse upper arg execname flag retcode 
if function = 'CLEAN-UP' then do 
"EXEC VMFVIEW' execname 


8. If, while viewing messages from the LAST run, you wish to check messages in previous runs, use the 
“ALL” XEDIT macro. This macro resets the “SET SELECT” and “SET DISPLAY” XEDIT 
sub-commands that are used by VMFVIEW. To return to a view of only the LAST run, press one of the 
PF keys that is set to select a subset of messages. 


The VMFVIEW Profile File 


VMFVIEW uses a profile file called VUFVIEW$ PROFILE. You can tailor this file to suit your needs. 
Figure 53 on page 705 shows the VMFVIEWS$ PROFILE file supplied by IBM. 
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KAKKKKKKKKEAREREREEKEKEREEREKKEKEEKEKEREEREREREREREERERREREEREREKEKE 


* THIS PRODUCT CONTAINS RESTRICTED MATERIALS OF IBM. x 
* COPYRIGHT - 5664-308 | * 
* (C) COPYRIGHT IBM CORPORATION - 1989 2 
i LICENSED MATERIAL - PROPERTY OF IBM . 


HEAKKEKRERKKEKEKEREREREREEEEEEEREREEREEKEEKEREEKEEREREREERERHREEEEE 
* 


* Name: VMFVIEW$ PROFILE 


* 


Function: Tailorable profile for VMFVIEW. 
Syntax of Entries in the Profile: 


* cmt 

VMFVIEW PFnn ( text ) key * cmt 
VMFVIEW INIT ( text ) key * cmt 
COMMAND xcmd 

MACRO xmac 


* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* where cmt is a comment. 

* nn is a number between 1 and 24 inclusive. 
* text is the text to describe a PF key. If 
* necessary, this field is truncated to 9 
* characters or padded with blanks. 

x key is one of the following: 

= "HELP' - display help screens 

* "ALL' - display all messages 

. 'QUIT' - exit from VMFVIEW 

* "BACKWARD' - display previous screen 

* "FORWARD' - display following screen 

- "xx2<,yy:<,zz:<...>>> with NO spaces 

- - display messages with the 
* listed headers : 
= "9XX3<,7yy3<,7ZZ:<...>>> with NO spaces 
. - display all messages except 
* those with the listed headers 
= xcmd is an Xedit command. 

* xmac is an Xedit macro. 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 


Usage Notes: 


1) Use an asterisk '*' to ‘comment out' old entries 
instead of deleting them or changing them directly. 
This will make it easier to recreate the original 
definitions. 


2) The valid headers are: 
BD:, CK:, MS:, RO:, RQ:, ST:, SV:, WN: 


3) It is recommended that PF keys 13-24 duplicate PF 
keys 1-12 because only PF keys 1-12 are displayed 
in VMFVIEW. If a PF key is not defined the Xedit 
default is used. 


t+ + + €¢ + & + + € & + #* FE He + F€ HF HF HF FE F SF HF SE FE FF F F FE FE FE FHF KF F F FE HF FF HF HF F OF KH HF 


Figure 53 (Part 1 of 2). VMFVIEWS PROFILE 
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4) The entries in this profile are processed in the 
same order in which they appear. This means that 


you can override previous settings. 


5) You may use the Xedit command SET PFxx. 
the text describing that PF key will be blank. 


syntax. 


7) The 3 lines on the top of the screen and the 2 lines 
above the bottom line of the screen are reserved for 


VMFVIEW. 


* 
* 
* 
* 
* 
* 
* 
* 6) Xedit commands and macros must have their correct 
* 
* 
* 
* 
* 
* 


¢ + ££ + ££ + + + F $F HF SF HF F 


HHH IAI IKE HIIII ARIA AAI ERR ARERIIAAREAIITAARARIIAARAAA I 


VMFVIEW INIT (Exception) CK:,MS:,RQ:,SV:,WN: 


VMFVIEW PFO1 (Help ) HELP 
VMFVIEW PFO2 (All ) ALL 
VMFVIEW PFO3 (Quit ) QUIT 


VMFVIEW PFO4 (Exception) CK:,MS:,RQ:,SV:,WN: 


VMFVIEW PFO5 (Status ) ST: 
VMFVIEW PFO6 (Build ) BD: 
VMFVIEW PFO7 (Backward ) BACKWARD 
VMFVIEW PFO8 (Forward ) FORWARD 
VMFVIEW PFO9 (OutCompRq) RO: 
VMFVIEW PF10 (Non-Stat ) -ST: 
VMFVIEW PF11 (Requisite) RQ: 
VMFVIEW PF12 (Severe ) SV: 
VMFVIEW PF13 (Help ) HELP 
VMFVIEW PF14 (All ) ALL 
VMFVIEW PF15 (Quit ) QUIT 


VMFVIEW PF16 (Exception) CK:,MS:,RQ:,SV:,WN: 


VMFVIEW PF17 (Status  ) ST: 
VMFVIEW PF18 (Build ) BD: 
VMFVIEW PF19 (Backward ) BACKWARD 
VMFVIEW PF20 (Forward ) FORWARD 
VMFVIEW PF21 (OutCompRaq) RO: 
VMFVIEW PF22 (Non-Stat ) 7ST: 
VMFVIEW PF23 (Requisite) RQ: 
VMFVIEW PF24 (Severe ) SV: 


REKRKEREKEEREKRREEKREEKREREREEREEEEREEERRREREEREREREREREEKEERRRKERK 


COMMAND SET ENTER IGNORE COMMAND CURSOR HOME PRIORITY 30 


COMMAND SET CMDLINE BOTTOM 
COMMAND SET CURLINE ON 4 

COMMAND SET MSGLINE ON 2 2 OVERLAY 
COMMAND SET MSGMODE ON LONG 
COMMAND SET COLOR MSGLINE RED 
COMMAND SET COLOR CURLINE WHITE 
COMMAND SET COLOR FILEAREA YELLOW 
COMMAND SET SCALE OFF 

COMMAND SET ETMODE OFF 

COMMAND SET SHADOW OFF 

COMMAND SET PREFIX OFF 


Figure 53 (Part 2 of 2). VMFVIEWS PROFILE 
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VMFZAP EXEC 


Use the VMFZAP EXEC procedure to apply ZAPs and to maintain a record of them in the ZAP log. 


Do not use this procedure to service any of the base components of VM/XA System Product. Use this 
procedure when applying PTFs to System Network Architecture (SNA) products. 


This EXEC uses the BASE disk, MERGE disk, and ZAP disk as inputs and produces an updated ZAP disk 
as output. 


Format 


The format of the VMFZAP EXEC is: 


VMFZAP prodid 


Where: 
prodid 
is the ID of the product you want to ZAP. 


When you issue VMFZAP, you must specify the name of the product you want to ZAP. VMFZAP accesses 
the disks using filemode letters E-N. VMFZAP accesses the MERGE disk ahead of the BASE disk. When 
VMFZAP processing stops, your search hierarchy is restored. 


In order to use VMFZAP, you MUST have an A-disk accessed in read/write mode. This disk MUST NOT 
be the ZAP disk, MERGE disk, or BASE disk. That is, the virtual address of your A-disk MUST NOT 
appear on the ZAP, MERGE, or BASE records of your VMFPARM file. 


How VMFZAP Works 


VMFZAP: 
1. Uses a parameter file to determine the virtual addresses of the ZAP, MERGE, and BASE disks. 
2. Reads the ZAP log and builds a list of TEXT filenames with ZAPs applied to them. Then it: 


e Erases all TEXT files in this list from the ZAP disk 
¢ Applies ZAPs to the first version of the TEXT file found among the other disks 


. Erases the ZAP log. 
. Reads the merge log and builds a list of ZAPs that are currently superseded. 
. Reads the ZAP List for the names of all ZAPs you want to apply. 


. Checks each ZAP name to see if it is superseded. If it is not superseded, then VMFZAP reads the 
control file for that ZAP. 


Control files for a product ZAP may contain information for ZAPping more than one text file. 
VMFZAP separates this information by text filename and processes the ZAP of each text file in the 
order they are listed in the control file. 


HR A & Ww 


Checks each text filename to see if it resides on some disk other than the ZAP disk. It is an error if 
the text file resides on the ZAP disk already. 
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If the text file exists, VMFZAP writes a temporary file called S$VMFZAP ZAP to the ZAP disk 
containing the ZAP control records for the current text file. 


Copies the text file to the ZAP disk under a temporary name of the format VMF$Tn TEXT, where n 
is a number determined by how many text files are affected by the ZAP currently being processed. 
When this temporary file has been successfully ZAPped it is renamed to its original name on the 


ZAP disk. 


7. Calls ZAPTEXT passing the $SVMFZAP name and the VMF5Tn filename to be ZAPped. 

Refer to “ZAPTEXT EXEC” on page 720 for more information about the ZAPTEXT command. 
8. Updates the ZAP log with the information about the TEXT file that was just ZAPped. 
9. Restores your disk search hierarchy once all ZAPs in the ZAPLIST have been processed. 


DMSWZP002E 
DMSWZP008E 
DMSWZP017E 
DMSWZP520E 
DMSWZPS545E 
DMSWZP649E 
DMSWZP653E 
DMSWZP856E 


DMSWZP858E 
DMSWMG859E 


DMSWMG860E 


DMSWZP%861I 
DMSWZP862I 
DMSWZP863E 
DMSWZP864W 
DMSWZP865I 
DMSWZP874E 
DMSWZP875E 
DMSWZP876E 


DMSWZP877W 
DMSWZP878E 
DMSWZP879W 
DMSWZP880E 
DMSWZPS8S1E 
DMSWZP885I 


DMSWZP886E 
DMSWZP887E 


File fn ft [fm] not found. 

Device vdev invalid or nonexistent. 

Invalid device address vdev. 

Invalid operand : operand. 

Missing operands. 

Extraneous parameter parm. 

Error executing command. 

Disk address vdev is listed more than once on the {BASE, ZAP | DELTA} and/or 
MERGE entry records in the prodid VMFPARM file. 

Unable to find a tag entry record in the fn ft file. 

The prodid VMFPARM file has no disk addresses on the {BASE | MERGE | ZAP} entry 
record. 

Only one {BASE | MERGE | ZAP} entry record may appear in the prodid VMFPARM 
file. 

Accessing disk_type disk vdev as mode. 

ZAP name has been action. 

The ZAP disk vdev must be linked read-write. 

ZAP name will not be action because it already is status. 

Processing ZAP name. 

Invalid entry found at line /ine in fn ft. 

File fn ft [/m] not found on any disks from the VMFPARM file. 

The total number of disk addresses on the BASE and MERGE entry records cannot exceed 
nine. 

jn TEXT was previously zapped but was not found on the ZAP disk. 

prodid ZAPLIST does not contain any unsuperseded zap names. No zaps will be applied. 
ZAP name name appears more than once in the /n ft [It will only be applied once. | 

Error in ZAPTEXT while processing fn TEXT. Textfiles affected by filename2 ZAP will 
not be saved on the ZAP disk. 

Jn TEXT was found on the zap disk but was not zapped during the VMFZAP run. This 
file should not be on the ZAP disk. 

File prodid VMFZPLOG not found on the ZAP disk. No text files will be removed from 
the ZAP disk. 

Filename name from the jn ft [f/m] file is longer than 8 characters. 

Record number number from the fn ft [f/m] file is longer than 80 bytes. 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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VSEVSAM EXEC 


Use the VSEVSAM EXEC to obtain VSE/VSAM Assembler Language macros from the Licensed Optional 
Machine Readable Materials tape. The VSEVSAM EXEC creates the VSEVSAM MACLIB for you. Once 
the MACLIB ts created, it contains all of the VSE/VSAM assembler language macros, and the following VSE 
macros: CDLOAD, CLOSE, CLOSER. GET, OPEN, OPENR, and PUT. 


The format of the VSEVSAM EXEC is: 


Example of Using VSEVSAM 


Before invoking the VSEVSAM EXEC, complete the following: 
1. Mount the Licensed Optional Machine Readable Materials tape at virtual address 181. 


2. Load the seven VSE macros from the Product Tape to MAINT 393 or a minidisk of your choice. (As 
long as the macros are available when VSEVSAM is invoked, the actual minidisk used is not critical.) 


Note: Because the seven VSE macros (CDLOAD, CLOSE, CLOSER, GET, OPEN, OPENR, and PUT) 
will be loaded into the MACLIB, they can be erased from the disk after the MACLIB is created. 


To invoke VSEVSAM EXEC, enter: 
vsevsam Hf 
Once invoked, VSEVSAM EXEC prompts you for information. For example, the system responds: 


DMSWVV797I "QUIT" may be entered in response to any query to 
end processing. 


DMSWVV788R Are the macros to be read from tape or are 
they already on disk? Reply TAPE or DISK. 
If a default of TAPE is to be used, press "ENTER." 
For this example, you read the macros from disk. Enter: 
disk @ 
The system responds: 
DMSWVV790R If the default library name of "VSEVSAM" is to be 
used, press "ENTER." Else, enter the name to be 
used for the library. 


You want to call the library VSAMMACS, so enter: 


vsammacs 
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The system responds: 


DMSWVV791I The library name will be "VSAMMACS." 
Press "ENTER" to continue, else enter 
"QUIT" or the name to be used for the library. 


Because VSAMMACS is the name we want to call the library, press: 
Zi 
The system responds: 


DMSWVV808R Macro library libname will be erased. 
Press "ENTER" to continue or type "QUIT" to exit. 


Because we want to erase old versions of the library that might be on our A-disk, press: 
a 
The system responds: 

DMSWVV793I Maclib generation completed. 


DMSWVV792R Are the macros to be erased from disk? 
Reply (YES | NO). Press "ENTER" for default 
of "YES." 


We want to erase the macros from disk, so press: 
a 
The system responds: 


DMSWVV802I Macros erased - VSEVSAM processing complete. 
Ready; 


Messages 


DMSWVV788R Are the macros to be read from tape or are they already on disk? Reply TAPE or DISK. 
If a default of TAPE is to be used, press “ENTER”. 

DMSWVV789W sesiInvalid response. 

DMSWVV790R If the default library name of “VSEVSAM” is to be used, press “ENTER”. Else, enter the 
name to be used for the library. 

DMSWVV791I The library name will be /ibname. Press “ENTER” to continue, else enter “QUIT” or the 
name to be used for the library. 

DMSWVV792R Are the macros to be erased from disk? Reply (YES | NO). Press “ENTER” for default 
of “YES”. 

DMSWVV7931 Maclib generation completed. 

DMSWVV794E Error in maclib generation. 

DMSWVV795E Error reading macros from tape. 

DMSWVV796E Error reading from “VSEVSAM SCAN” file. 

DMSWVV797I “QUIT” may be entered in response to any query to end processing. 
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DMSWVV799E 
DMSWVV800E 
DMSWVVS801I 
DMSWVVS802I 
DMSWVV808R 


DMSWVVS809E 


VSEVSAM EXEC 


The VSE/VSAM Optional Source Statement Library tape must be mounted as virtual 181. 
If it is not, enter “QUIT” here and have the tape mounted. Else, press “ENTER” to 
continue. 

Error reading from “VSEVSAM SCAN?” file - all macros may not be erased. 

One of the files needed for maclib generation is missing. 

Arguments entered are ignored. 

Macros erased - VSEVSAM processing complete. 

Macro library libname will be erased. Press “ENTER” to continue or type “QUIT” to 
exit. 

Error copying “VSEVSAM SCAN?” file from S-disk to A-disk. 
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ZAP MODULE 


ZAP is a CMS command that changes or dumps MODULE, LOADLIB, or TXTLIB files. It may be used 
to change either fixed or variable length MODULE files. It is for use by system support personnel only. 


Input control records control ZAP processing. They can be submitted either from the terminal or from a 
disk file. Using the VER and REP control records, you can verify and replace data or instructions in a 


control section (CSECT). Using the DUMP control record, you can dump all or part of a CSECT, an entire 
member of a LOADLIB or TXTLIB file, or an entire module of a MODULE file. 


Format 


The format of the ZAP MODULE is: 


MODULE 


LOADLIB [Libnamel ... libname3] [(option...[)]] 
TXTLIB 


options: 


TERM 
INPUT filename 


Where: 


MODULE 
LOADLIB 
TXTLIB 
indicates the type of file that you want to change or dump. 


libname 
is the filename of the library containing the member you want to change or dump. You can specify one 
to three library names. This operand is valid only for LOADLIB and TXTLIB files. 


options: 


TERM| 5 RINT 


NOPRINT 

indicates that input to the ZAP service program is submitted through the terminal. If you specify 
TERM, the prompting message ENTER: is issued, and you can then enter input control records up to 
80 characters long. If you specify PRINT with TERM, all output prints on the printer, but only 
error messages display at the terminal. If you specify NOPRINT with TERM, nothing prints on the 
printer, and all output except control records displays at the terminal. See Table 21 on page 713. 


NOPRINT 


specifies that input is submitted from a disk file called filename. This file must have a filetype of 
ZAP, and must be a fixed 80-byte sequential file residing on any accessible device. If you specify 
PRINT with INPUT filename, all output produced by the ZAP service program prints on the printer. 
In addition, commands in error, control records in error, and error messages display at the terminal. 
If you specify NOPRINT with INPUT /ilename, nothing prints on the printer, and ail output 
displays at the terminal. See Table 21 on page 713. 


INPUT filename| SPR | 
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Table 21. Valid Options and Their Output 


INPUT 


Everything prints on the printer. Commands | Nothing prints on the printer. Everything 
in error, control records in error, and error displays on the terminal. 
messages display on the terminal. 


Everything prints on the Printer. Error Nothing prints on the printer. Everything 
messages display on the terminal. except control records displays on the 
terminal. 


Input Control Records 


There are eight types of ZAP control records: 


The ZAP program can accept only 80 characters of data for each control record. ZAP control records are 
free-form and need not start in position one of the record. Separate all information by one or more blanks. 
All address fields including disp (displacement) fields in VER and REP control records must contain an even 
number of hexadecimal digits, to a maximum of six digits (X'OD', X'02C8', X'014318'). Data fields in 
VER and REP control records must also contain an even number of hexadecimal digits. 


If you want, you can separate the data anywhere by commas (for example, 83256482 or 8325,6482). The 
commas have no effect on the operation. 


Note: Do not use blank spaces as separators within data fields. 


The program sets the NOGO switch on if it finds a control record in error. A file cannot be changed if the 
NOGO switch is turned on. The next valid NAME record turns the NOGO switch off. This means that if 
the control record is the NAME record, all succeeding records are ignored until the next NAME, DUMP, or 
END record. For any other error, only REP control records that follow are ignored. 


DUMP Control Record 


The DUMP control record allows you to dump a portion or all of a specified control section, or the complete 
member or module. The format of the output of the dump is hexadecimal with an EBCDIC translation of 
the hexadecimal data. 


The DUMP control record is optional and resets the NOGO switch off. The DUMP control record must not 


immediately precede a BASE, VER, or REP control record. A NAME control record must precede the 
BASE, VER, and REP control records (if any) that follow a DUMP control record. 
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Format: 


pretend — [startaddress en 


modulename ALL 


Where: 


membername 
is the name of the member you want to dump, or the member that contains the CSECT(s) you want to 
dump. This member must be in one of the libraries you specify on the ZAP command. 


For a CMS TXTLIB, the format of the dump control record requires that you specify both membername 
and CSECTname. Because the library directory does not contain member names, any word may be used 
to replace membername. The program searches for only the second name following the dump operand; 
therefore, the second name must be CSECTname. 


modulename 
is the name of the module you want to dump, or the module that contains the CSECTs you want to 
dump. If you specify a module that has no loader table, the program dumps the entire module. 


CSEC Tname 
is the name of the control section that you want to dump. If you do not specify CSECTname, the 
program dumps only the first CSECT. CSECTname is required for CMS TXTLIBs, but is optional for 
OS TXTLIBs, LOADLIBs, and MODULE files. (See the discussion of CSECTname in “NAME Control 
Record” on page 715). You must not specify CSECTname for a module created with the NOMAP 
option. 


startaddress 
is the location within the specified CSECT where you want the dump to begin. This must be two, four, 
or six hexadecimal digits. The start address is the displacement from the beginning of the CSECT. For 
example, to start dumping at address 08 in a CSECT that begins at location X'400', you specify start 
address X'08', not X'0408'. 


endaddress 
is the last address you want to dump. This must be two, four, or six hexadecimal digits. If you do not 
specify endaddress, the program dumps from startaddress to the end of the CSECT. Note that start and 
end addresses apply only when you specify CSECTname. 


ALL 
tells the program to dump all CSECTs within the member or module you specify. You can specify ALL 
for MODULE files, LOADLIBs, and OS TXTLIBs, but not for CMS TXTLIBs. To dump all the 
CSECTs in a member of a CMS TXTLIB, you must issue a separate DUMP control record for each 
CSECT. 


Usage Notes: 


1. Displacements listed in the dump output for a module file are calculated from the beginning location of 
the module. Therefore, the addresses in the output may differ from the displacements within a CSECT. 


2. If a DUMP control record references a TXTLIB file that contains ORG statements causing more than 
one occurrence of an address, data found at the first occurrence is displayed, but any subsequent 
redefinition of data for the same location is ignored. 
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NAME Control Record 

The NAME control record specifies the member or module and CSECT that contain the data you want the 
ZAP operation to verify or replace. The NAME control record must precede the BASE, VER, and REP 
control records. If it does not, the program sets the NOGO switch on. 


Format: 


pars towel [csectname ] 


modu lename 


Where: 


membername 
is the member that you want to search for the desired CSECT. 


modulename 
is the module that you want to search for the desired CSECT. 


CSEC Tname 
is the name of the control section you want to change. 


1. You must specify CSECTname if the CSECT you want to change is in a CMS TXTLIB (that is, a 
TXTLIB created by the TXTLIB command from CMS TEXT decks that do not have a NAME card 
following the END card). The directory of a CMS TXTLIB contains only CSECT names and no 
member names. Select a word to replace membername as the first entry following the NAME operand in 
the NAME statement for a CMS TXTLIB. 


Note: The word you specify for the membername for a CMS TXTLIB should be a meaningful name. 
The filename of the LOG control record is determined by the membername or modulename you 
specify in the NAME control record. 


2. The CSECT name you specify in the NAME record is compared with CSECT names in the directory. If 
the CSECTs match and no member name match is found, the member selected is the one that contains 
the CSECT name. 


3. CSECTname is optional if the CSECT you want to change is a LOADLIB or an OS TXTLIB (that is, a 
TXTLIB created by the TXTLIB command from CMS TEXT decks that have a NAME card after the 
END card). The dictionaries of the specified libraries are searched for the member name and the 
member is then searched for the CSECT name, if you specified one. If you do not specify CSECTname 
for a LOADLIB or an OS TXTLIB, the program uses the first control section. 


4, CSECTname is optional fora MODULE file. The module named in the NAME control record is found 
and, if you specify CSECTname, the first record is read to determine the number of records in the 
module and the availability of a loader table, which the program can then search for CSECTname. If 
you do not specify CSECTname, the program uses the beginning location of the module. You cannot 
specify CSECTname if the module was created with the NOMAP option. 
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BASE Control Record 


The BASE control record adjusts displacement values for subsequent VER or REP control records for a 
CSECT whose starting address is not location zero in an assembly listing. 


The BASE control record is optional. See the discussion under “VER or VERIFY Control Record.” If you 
specify the BASE control record, it must follow the NAME record, but it need not follow the NAME record 
immediately. For example, you could have the following sequence of control records: NAME, VER, REP, 
BASE, VER, REP. 


Format 

BASE address | 
Where: 
address 


is the starting address of the CSECT. It must be two, four, or six hexadecimal digits. 


Usage Note: If you do not specify a CSECTname in the NAME control record, you cannot specify any 
BASE value other than 00. | 


Example: For a CSECT starting at location X'400', you specify BASE 0400 in the BASE control record. If 
a subsequent VER card requests verification of location X'0408', BASE 0400 is subtracted from X‘0408', 
and the program verifies location X'08' in the CSECT. This example applies if you specify TXTLIB, 
LOADLIB, or MODULE and the module map is present. 


However, if no module map is present fora MODULE file (that is, the module was generated with the 
NOMAP option), then all operations are done as if the BASE address is location X'0'. For example, if you 
specify a BASE of X'400' and the address you want to look at or change in X'408', then you must specify 


X'08' and not X'408' in the REP and VER control records. The address in this case is from the start of the 
module. 


VER or VERIFY Control Record 


The VER control record requests verification of instructions or data within a CSECT. If the verification 
fails, the program does not do a subsequent REP operation until it finds another NAME control record. 


The VER control record is optional. More than one VER record can follow a single NAME record. 


Format: 


oe 
VER 


716 Installation and Service 


ZAP MODULE 


Where: 

disp 
is the displacement from the start of the CSECT containing the data to be inspected, if you did not 
submit a BASE control record for this CSECT. disp can also be the actual location of the data to be 
inspected, if you did submit a BASE control record. disp must be two, four, or six hexadecimal digits. 
This displacement does not have to be aligned on a fullword boundary. If this displacement value ts 
outside the limits of the CSECT specified by the preceding NAME control record, the VERIFY control 
record Is rejected. 


data 
is the data against which the data in the CSECT is compared. This must be an even number of 
hexadecimal digits. 


Usage Note: If the VER control statement references data in a TXTLIB file that 1s later redefined by ORG 
statements, only the first data definition is verified. 


Example: If the location you want to verify is X'3CC', and the CSECT begins at location X'2B0', you can 
enter: 


base 02B0 
ver 03CC datc 


or you can omit the BASE control record, subtract the CSECT start address from the address of the data. 
and enter: 


ver 011C dotc & 
REP Control Record 


The REP control record changes instructions or data at the specified location within the CSECT that you 
specify in a preceding NAME control record. The data specified in the REP control record replaces the data 
at the CSECT location specified by the disp operand. This replacement is on a one-for-one basis; that is, one 
byte of data defined in the control record replaces one byte of data at the location that you specified. If the 
replacement fails, the program does not do additional REP operations until it finds another NAME control 
record. 


The REP control record is optional. More than one REP record can follow a single NAME record. 


Format: 


REP disp data 


Where: 


disp 
is the displacement from the start of the CSECT of the data you want to replace (if you did not submit a 
BASE control record for this CSECT). disp can also be the actual location of the data if you did submit 
a BASE control record. disp must be two, four, or six hexadecimal digits. This displacement need not 
address a fullword boundary. If this displacement value is outside the limits of the CSECT being 
changed, the program does not do the replacement operation. 


data 
is the data that is to replace the data in the CSECT. This must be an even number of hexadecimal digits. 
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Usage Notes: 


1. Although you do not have to verify a location before replacing data, you should do so to make sure that 
the data being changed is what you expect it to be. 


2. If the REP control statement references data in a TXTLIB file that is later redefined by ORG statements, 
the replacement of data takes place at the first occurrence of the data address of the TXTLIB member. 


Example: If the location you want to replace is X'3CC', and the CSECT begins at location X'2B0', you 
can enter: 


base 02B0 & 
rep 03CC data @ 


or you can omit the BASE control record, subtract the CSECT start address from the address of the data, 
and enter: 


rep 011C data 

LOG Control Record 

The LOG control record lets you specify, after you apply a fix, a unique fix number, which is recorded in a 
log file for the module or member. The filename of the log file is the same as membername or modulename in 


the NAME control record. 


Format: 


fixnum filetype [user data] 
ZAPLOG 


Where: 


fixnum 
specifies the number associated with the fix. Its length may vary from 1-to 8-alphameric characters. 


filetype 
specifies the filetype of the log. The default is ZAPLOG. 


user data 
specifies any data that you want to enter into the log. If you specify user data, you must specify filetype. 
Usage Notes: 


1. The LOG control record is optional and is allowed only if valid NAME and REP control records are 
found. The filename is obtained by the log routine from modulename or membername in the NAME 
control record. However, if no LOG control record is found, a dummy log record is written at the end 
of the user’s valid REPs. 


2. Log multiple names by including a LOG control record after each name. If the LOG record is not 
included after each name, error message DMSZAPO70E results. Processing continues after the error 
messages Occur. 


3. The LOG record is 80 bytes in length and contains the following information: 


¢ Columns | — 63 contain the fixnum and, if specified, the filetype and user data 
¢ Columns 64-80 contain the date and time of the ZAP. 
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COMMENT Control Record 


The ZAP program ignores COMMENT control records. If the PRINT option is in effect, the program prints 
the comments. 


Format: 


There must be at least one blank following the asterisk (*) before you enter the text. 
END Control Record 


The END control record ends ZAP processing. The END record is required and must be the last control 
record for input from the console. 


Format: 


Special Considerations for Using the ZAP Service Program 


Before using the ZAP command against MODULE files, you can use the MODMAP command to determine — 
whether a module map exists and what it contains. 


When a ZAP input file has more than one pair of VER and REP control records, and a VER control record 
(other than the first) fails, you must remove the records prior to the failing record and correct the error 
before you issue the ZAP command again. Otherwise, the file being changed returns to its original status. 


The REP control record cannut be used to place data in an undefined area such as a Define Storage area. If 
any part of a data field specified in a pair of VER and REP control records is an undefined area, the system 
displays warning message DMSZAP248W, and no data replacement occurs. If you do not issue a VER 
control record prior to the REP control record, some change to data may result. User-defined data may be 
inserted in undefined areas of text files by using the REP statement described under the LOAD command. 


If the file to be dumped contains undefined areas (such as a DS or ORG statement in a TXTLIB member), 
the hexadecimal portion of the dump contains blanks to indicate that the corresponding positions are 
undefined. 


VER and REP control words can be used to change TXTLIB members produced by FORTRAN compilers 
that store the length of the compiled text in the END card rather than in the ESD card. However, if a 
member of this type contains multiple CSECTs, only the first CSECT can be changed by the ZAP program. 


The TXT records should be in ascending address order. If ZAP finds a TXT record with an address higher 
than the specified address, it stops scanning for the specified address. This means that ZAP control records 
affect only the data at the first occurrence of the address. 

When applying ZAPs to a text deck created by a compiler, be aware that some compilers, such as 
FORTRAN, may generate a text deck in which the TXT records are not in ascending address order. 


Appendix B. EXEC and Command Format Summaries 719 


ZAPTEXT 


ZAPTEXT EXEC 


ZAPTEXT EXEC modifies or dumps individual text files. Use ZAPTEXT like the ZAP service program, but 
only for text files, not for MODULEs, TXTLIBs, or LOADLIBs. (Use ZAP to process MODULEs, 
TXTLIBs, and LOADLIBs.) ZAPTEXT uses the same control information as ZAP and can also use the 
EXPAND ZAP control word. The user’s A-disk must be accessed as read/write to use ZAPTEXT. 


Format 


The format of the ZAPTEXT EXEC is: 


ZAPTEXT fn (ft Cfmj]  l[foptions: ... [)]] 


options: 


[ INPUT filename ] [PRINT ] 
[ NOPRINTI 


Where: 


fn ft fm 
is the file ID of the text file that you want to change. If you do not specify the filetype or filemode, the 
system assumes a filetype of TEXT and a filemode of Al. The filemode must specify a read/write disk. 


options: 


INPUT filename 
identifies the file that has the ZAP control records. This file must: 


e Have a filetype of ZAP, and 
¢ Bea fixed 80-byte sequential file that resides on any accessible disk. 


If you do not specify filename, it defaults to whatever you specify as fn on the ZAPTEXT command. 


PRINT 
prints all output produced by ZAPTEXT on the printer. The system also displays error messages, 
commands in error, and control records in error at the terminal. 


NOPRINT 
does not print anything on the printer, and instead displays all output at the terminal. 


ZAPTEXT Input Control Records 

Control Records Also Used by ZAP 

ZAPTEXT uses the same control information as the current ZAP service program, with the addition of the 
EXPAND control record. The ZAP service program ignores any EXPAND control records. Refer to “Input 
Control Records” on page 713 for information about the control records, other than EXPAND, that 
ZAPTEXT uses. 


Use the ZAP control records with ZAPTEXT according to ZAP’s TXTLIB conventions. 
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EXPAND Control Record 
The EXPAND control record lets you increase the size of a named control section contained in the text file. 


Format: 


EXPAND csect size [ , csect size ...] 


Where: 


csect 
specifies the symbolic name of a control section whose length you want to increase. 


size 
specifies the decimal number of bytes for the system to add to the control section length. The system 


initializes the added bytes to binary zero. The maximum number of bytes for each control section that 
you indicate is 4095. 


Control Record Usage Notes 


1. Each control record may have multiple entries, but you must separate them with commas. Do not spill 
an entry onto the next line. 


2. The system processes all EXPAND control records before any other control records, regardless of their 
position in the control file. 


3. The effective length of the expansion, which is the actual number of bytes added to the control section, 
may be greater than the length that you specify for the expansion. This may occur if, after the specified 
expansion, the system must add padding bytes to align the next control section or common area. 


4. When you increase a control section’s size, it may affect the offset address of any following control 
section. This is important when you determine values for BASE, REP, and VER control records. Use 
the effective expansion lengths when you are determining control section offsets. 


EXPAND Command 


ZAPTEXT calls EXPAND if you specify an EXPAND control record in the ZAP control file. Use 
EXPAND to add space to a program in object deck form. The system creates object decks when you 
assemble or compile a source program. This is especially useful when you do not have the source code for a 
program or the program does not have a patch area. 


Note: EXPAND can add extra space only at the end of named control sections (CSECTs). EXPAND 
cannot expand private code (unnamed CSECT) and common areas (named or unnamed). | 


Do not increase the length of a program beyond its design limitations. For example, if you add space 
to a control section beyond the range of its base register addressability, that space is unusable. 
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ZAPTEXT 


Format 


The format of the EXPAND command is: 


fnl [ft1 (fmt ([fn2 ([ft2 [fm2]])]] {(options: ... [)]] 


options: 


INPUT filename | Ee | 
CSECT csect SIZE size NOPRINT. 


Where: 
ful fel fml 


identifies the input text file that the system expands. The file must have valid object deck information, 
like that created by an assembler or compiler. If you do not specify the filetype or filemode, the system 
assumes a filetype of TEXT and filemode of Al. 


Note: EXPAND assumes that the input text file follows OS/VS standards and that the OS/VS Linkage 
Editor will accept it without error. The system does a limited check for errors. If the input file is 
invalid, the system may not expand the text file correctly. 


fn2 ft2 fm2 
identifies the output text file that the system creates. You can use an equal sign (=) for any of the file 
identifiers to indicate that it is the same identifier as fn/, ftl, or fml. The default fileid is $fnJ = =. 
The system truncates the filename (fn/) to 7 characters before appending the $. In any case, fm2 must be 
a read/write disk and cannot be an asterisk (*). 


options: 


INPUT filename 
identifies an EXPAND input file that contains EXPAND control records. If you do not specify 
INPUT, the filename defaults to the name of the text file that you are expanding (f/n/). The filetype 
must be EXPAND. The system searches all accessed disks for this file. 


Do not specify this option with the CSECT or SIZE options. 


CSECT 
specifies the symbolic name of a control section whose length the system will increase. If you specify 
CSECT, you must also specify SIZE. 


Do not specify CSECT with the INPUT option. 


SIZE 
specifies the decimal number of bytes that the system adds to the control section length. The system 
initializes the added bytes to binary zeros. The maximum number of bytes for each control section is 
4095. If you specify SIZE, you must also specify CSECT. 


Do not specify SIZE with the INPUT option. 


PRINT 
prints on the printer all output that EXPAND produces. In addition, the system displays error 
messages, commands in error, and control records in error at the terminal. 


NOPRINT 
does not print any output on the printer, and instead displays it at the terminal. 
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ZAPTEXT 


e After the system expands each CSECT that you specified, the system issues a message indicating the 
following: 


— The number of bytes added to the control section. 


— Whether the number of bytes added is greater than the length that you specify for the expansion. 


This may occur if, after the specified expansion, the system must add padding bytes to align the next 
control section or common area. 


The offset, relative to the start of the specified control section where the expansion began. 


If the system finds an error during processing, it stops the update and does not do the expansions. 
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Appendix C. VM/XA System Product Starter System 
Information 


This section presents the following information: 


The minimum hardware configuration needed to generate VM/XA System Product. 


Sample files that IBM provides with the VM/XA System Product. (For a sample product parameter file, 
see “A Sample Product Parameter File” on page 384.). 


Allocations of the system residence device for starter systems. 


Minidisk maps of 3350, 3375, 3380, 3380-E4, 3380-K, 3390, and 3391 system residence devices, based on 
sample directories. 


Minimum Hardware Configuration 


The minimum hardware configuration needed to generate VM/XA System Product is: 


© Qne processor (that supports VM/XA SP) with: 


— Processor in 370-XA mode 

— At least 4 megabytes of real storage 
— One processor unit 

— One processor controller 

— One channel processor 


One system console. 
One printer. 


Direct access storage devices. The number required depends on the type of DASD used. 


Number of 
DASD Type DASD 
3350 4 
3375 3 
3380 2 
3380-E4 l 
3380-K l 
3390 l 


One magnetic 9-track tape unit with data density of 6250 BPI. (A second tape unit is recommended, but 
not required.) 


e One operator’s console. 


IBM supplies the following VM/XA SP starter systems: 


3350 
3375 
3380 (for 3380, 3380-E4, and 3380-K DASD) 
3390 
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a emcee i oe 


DMSNGP ASSEMBLE 


DMSNGP ASSEMBLE (CMS Nucleus Generation Profile) 


This profile is part of the Starter System. Within this file, you must change CYLADDR =? to the address of 
the starting cylinder or block where the nucleus is to be written. Also, you may want to change the 
VERSION and INSTID names to whatever is appropriate for your installation. 


NGP TITLE 'DMSNGP (CMS) VM/XA SYSTEM PRODUCT 5664-308' 
EJECT 
DMSNGP CSECT ; 
DEFNUC SYSDISK=190, * §-disk address * 
YDISK=19E, * Y-disk address * 
HELP=19D, * Help disk address * 
LANGID=AMENG, * Default is American English * 
DBCS=NO, * Default is not a DBCS lang * 
LANGLEV=S, * DCSS ID for multiple DCSS * 
SAVESYS=NO, * Using CMS in DCSS YES OR NO sf 
SYSNAME=CMS , * Name of above DCSS to save * 
USEINST=YES, * Using EXEC/XEDIT in DCSS = 
INSTSEG=CMSINST, * Name of above DCSS to save . 
REWRITE=YES, * Write nucleus yes or no * 
IPLADDR=190, * Address of where to write . 
CYLADDR=?, * CYL/BLK of where to write * 
IPLCYLO=YES, * write ip] text on cyl 0 * 
VERSION=?, * VM/XA CMS 5.6 MM/DD/YY HH MM SS * 


INSTID='VM/XA CONVERSATIONAL MONITOR SYSTEM' 
END 
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Sample HCPRIO ASSEMBLE File 


HCPRIO ASSEMBLE 


IBM supplies the following sample file with VM/XA SP. It is only a sample file, and must be tailored to your 


installation before it can be used. 
RIO TITLE 'HCPRIOXA - HCPRIO FOR VM/XA SYSTEM PRODUCT  ' 


HIKKEKKEEREREKEEEREEREEREEKEREEKREREREKEEEEREREREERREREREEKEERKE 


wee Virtual Machine / System Product 5664-308 *** 
wee Copyright (c) I BM Corporation 1988, 1989 *** 
ili Licensed Materials - Property of I BM axe 


wee Refer to Copyright Instructions: Form G120-2083 ee 


KEEKKKEKKEKKEKEKEREEEEELEKKREKKEEKEEREKEREEEEKEREREREKREREEAKEER 
RHEEKKEKKEKKREKKKEEEKEEREREEEEKEREEREREREREEREREKREERERKEEKEKEKKEKE 
* 


* MODULE NAME - HCPRIO 


* 


* DESCRIPTIVE NAME - DEFINITION OF REAL DEVICES 


* 
* 


* FUNCTION - TO DEFINE THE REAL DEVICES 


RANGING FROM 9 TO 15. 
PATCH LABEL - NONE 
MODULE TYPE - DATA 
PROCESSOR - ASSEMBLER H (VERSION 2) 
ATTRIBUTES - RESIDENT, DATA-ONLY 
MACROS - 
RDEVICE - DEFINE REAL DEVICES 
RIOGEN - END REAL. DEVICE GENERATION 
GENERAL COMMENTS - THIS MODULE IS THE USER'S RESPONSIBILITY. 


INPUT FILE. 


+ +t + $$ ££ F£ FF HF SH F F HF H H F HF HF F HF F SH F 


KREKKEKREEEEEEEREREEREEREEEEEREEREREEREREEEREREEKREREEREEREREEEREEREREREKS 


PRINT NOGEN 
EJECT 


* THE RDEVICE MACROS ARE CODED HERE, ONE FOR EACH DEVICE OR 
* GROUP OF DEVICES 


RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(070,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS ,MODEL=6 , DEVNO=(170,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS ,MODEL=6 , DEVNO=(270,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(370,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(470,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS ,MODEL=6 , DEVNO=(570,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS ,MODEL=6 , DEVNO=(670,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(770,8) 


REGISTER CONVENTIONS - SYMBOLIC REFERENCES TO REGISTERS ARE 
OF THE FORM "RX" WHERE X IS A NUMBER 


THIS SAMPLE IS BASED UPON THE STARTER IOCP 
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HCPRIO ASSEMBLE 


RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(870,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(970,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS ,MODEL=6 , DEVNO=(A70,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(B70,8) 
* 

RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(080,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(180,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(280,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6, DEVNO=(380, 8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6,, DEVNO=(480,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(580, 8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(680, 8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(780,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(880, 8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(980, 8) 
* 

RDEVICE DEVTYPE=3422 , DEVNO=(A80,8) 

RDEVICE DEVTYPE=3422 ,DEVNO=(B80,8) 

* 

RDEVICE DEVTYPE=3430,DEVNO=(C80,8) 

RDEVICE DEVTYPE=3430,DEVNO=(D80,8) 

* 

RDEVICE DEVTYPE=3330 ,MODEL=1,DEVNO=(078,8) 

RDEVICE DEVTYPE=3330,MODEL=1 ,DEVNO=(178,8) 

RDEVICE DEVTYPE=3330,MODEL=1, DEVNO=(278,8) 

RDEVICE DEVTYPE=3330,MODEL=1 , DEVNO=(378,8) 

RDEVICE DEVTYPE=3330,MODEL=1, DEVNO=(478,8) 

RDEVICE DEVTYPE=3330,MODEL=1 ,DEVNO=(578,8) 

* 

RDEVICE DEVTYPE=3330 ,MODEL=11, DEVNO=(050,8) 

RDEVICE DEVTYPE=3330 ,MODEL=11,DEVNO=(150,8) 

RDEVICE DEVTYPE=3330 ,MODEL=11 , DEVNO=(250,8) 

RDEVICE DEVTYPE=3330,,MODEL=11 , DEVNO=(350,8) 

RDEVICE DEVTYPE=3330,MODEL=11,DEVNO=(450,8) 

RDEVICE DEVTYPE=3330 ,MODEL=11 , DEVNO=(550,8) 

* 

RDEVICE DEVTYPE=3330 ,MODEL=11 , DEVNO=(058,8) 

RDEVICE DEVTYPE=3330,MODEL=11,DEVNO=(158,8) 

RDEVICE DEVTYPE=3330,MODEL=11, DEVNO=(258, 8) 

RDEVICE DEVTYPE=3330,MODEL=11 , DEVNO=(358,8) 

RDEVICE DEVTYPE=3330,MODEL=11 , DEVNO=(458, 8) 

RDEVICE DEVTYPE=3330 ,MODEL=11 , DEVNO=(558,8) 

* 

RDEVICE DEVTYPE=3340,DEVNO=(GCO,8) 

RDEVICE DEVTYPE=3340, DEVNO=(1C0,8) 

RDEVICE DEVTYPE=3340, DEVNO=(2C0,8) 

RDEVICE DEVTYPE=3340, DEVNO=(3C0,8) 

RDEVICE DEVTYPE=3340, DEVNO=(4C0,8) 

RDEVICE DEVTYPE=3340, DEVNO=(5C0,8) 

* 

RDEVICE DEVTYPE=3350, DEVNO=(048,8) 

RDEVICE DEVTYPE=3350, DEVNO=(148,8) 

RDEVICE DEVTYPE=3350, DEVNO=(248,8) 

RDEVICE DEVTYPE=3350, DEVNO=(348,8) 

RDEVICE DEVTYPE=3350, DEVNO=(448,8) 

RDEVICE DEVTYPE=3350, DEVNO=(548, 8) 

* 

RDEVICE DEVTYPE=3350,DEVNO=(030,8) 

RDEVICE DEVTYPE=3350, DEVNO=(130,8) 

RDEVICE DEVTYPE=3350,DEVNO=(230,8) 
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RDEVICE DEVTYPE=3350, DEVNO=(330,8) 
RDEVICE DEVTYPE=3350, DEVNO=(430,8) 
RDEVICE DEVTYPE=3350, DEVNO=(530,8) 
* 

RDEVICE DEVTYPE=3350, DEVNO=(060,8) 
RDEVICE DEVTYPE=3350, DEVNO=(160,8) 
RDEVICE DEVTYPE=3350, DEVNO=(260,8) 
RDEVICE DEVTYPE=3350, DEVNO=(360,8) 
RDEVICE DEVTYPE=3350, DEVNO=(460,8) 
RDEVICE DEVTYPE=3350, DEVNO=(560,8) 
* 

RDEVICE DEVTYPE=3375, DEVNO=(090, 8) 
RDEVICE DEVTYPE=3375,DEVNO=(190,8) 
RDEVICE DEVTYPE=3375, DEVNO=(290,8) 
RDEVICE DEVTYPE=3375,DEVNO=(390,8) 
RDEVICE DEVTYPE=3375,DEVNO=(490,8) 
* 

RDEVICE DEVTYPE=3375, DEVNO=(068,8) 
RDEVICE DEVTYPE=3375,DEVNO=(168,8) 
RDEVICE DEVTYPE=3375, DEVNO=(268,8) 
RDEVICE DEVTYPE=3375 , DEVNO=(368,8) 
RDEVICE DEVTYPE=3375, DEVNO=(468,8) 
RDEVICE DEVTYPE=3375,DEVNO=(568,8) 
RDEVICE DEVTYPE=3375, DEVNO=(668,8) 


RDEVICE DEVTYPE=3380, DEVNO=(038,8) 
RDEVICE DEVTYPE=3380, DEVNO=(138,8) 
RDEVICE DEVTYPE=3380,DEVNO=(238,8) 
RDEVICE DEVTYPE=3380, DEVNO=(338,8) 
RDEVICE DEVTYPE=3380, DEVNO=(438, 8) 
RDEVICE DEVTYPE=3380, DEVNO=(538,8) 
RDEVICE DEVTYPE=3380, DEVNO=(638,8) 
* 
RDEVICE DEVTYPE=3380, DEVNO=(@A0,8) 
RDEVICE DEVTYPE=3380,DEVNO=(1A0,8) 
RDEVICE DEVTYPE=3380, DEVNO=(2A0,8) 
RDEVICE DEVTYPE=3380 , DEVNO=(3A0,8) 
RDEVICE DEVTYPE=3380,DEVNO=(4A0,8) 
* 
RDEVICE DEVTYPE=3390 ,DEVNO=(5A0,8) 
RDEVICE DEVTYPE=3390 , DEVNO=(6A0, 8) 
RDEVICE DEVTYPE=3390 , DEVNO=(7A0,8) 
* 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(OFO, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(1F0, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 ,DEVNO=(2FQ, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(3F0, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2, DEVNO=(4F0, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(5F0, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(6F0, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(7F0,1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(8FO, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(9FO, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(AFQ, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(BFQ, 1) 
*% 
RDEVICE DEVTYPE=2305 ,MODEL=2 ,DEVNO=(@D0, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 ,DEVNO=(1D0, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(2D0, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(3D0, 1) 
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RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(4D0, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(5D0, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(6D0, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(7D0, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(8D8, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(9D0,1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(AD®@, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(BD0, 1) 


RDEVICE DEVTYPE=3800 ,DEVNO=(018, 1) 
RDEVICE DEVTYPE=38600 ,DEVNO=(118, 1) 
RDEVICE DEVTYPE=3800,DEVNO=(218, 1) 
RDEVICE DEVTYPE=3800,DEVNO=(318, 1) 
RDEVICE DEVTYPE=3860 ,DEVNO=(418, 1) 
RDEVICE DEVTYPE=3800 , DEVNO=(518, 1) 
RDEVICE DEVTYPE=3860 ,DEVNO=(618, 1) 


RDEVICE DEVTYPE=3262 ,DEVNO=(0A8, 1) 
RDEVICE DEVTYPE=3262 ,DEVNO=(1A8, 1) 
RDEVICE DEVTYPE=3262 ,DEVNO=(2A8, 1) 
RDEVICE DEVTYPE=3262 , DEVNO=(3A8, 1) 
RDEVICE DEVTYPE=3262 , DEVNO=(4A8, 1) 
RDEVICE DEVTYPE=3262 , DEVNO=(5A8, 1) 


RDEVICE DEVTYPE=4245 , DEVNO=(OBO, 1) 
RDEVICE DEVTYPE=4245 , DEVNO=(1B0, 1) 
RDEVICE DEVTYPE=4245 ,DEVNO=(2B0,1) 
RDEVICE DEVTYPE=4245 , DEVNO=(3B0, 1) 
RDEVICE DEVTYPE=4245 , DEVNO=(4B0, 1) 
RDEVICE DEVTYPE=4245 , DEVNO=(5B0, 1) 


RDEVICE DEVTYPE=4248, DEVNO=(0B8, 1) 
RDEVICE DEVTYPE=4248 , DEVNO=(1B8, 1) 
RDEVICE DEVTYPE=4248, DEVNO=(2B8, 1) 
RDEVICE DEVTYPE=4248, DEVNO=(3B8, 1) 
RDEVICE DEVTYPE=4248 , DEVNO=(4B8, 1) 
RDEVICE DEVTYPE=4248, DEVNO=(5B8, 1) 


RDEVICE DEVTYPE=3278 ,MODEL=2 , DEVNO=(020,8) 
RDEVICE DEVTYPE=3278 ,MODEL=2 , DEVNO=(120,8) 
RDEVICE DEVTYPE=3278 ,MODEL=2 , DEVNO=(220,8) 
RDEVICE DEVTYPE=3278 ,MODEL=2 , DEVNO=(320,8) 
RDEVICE DEVTYPE=3278, MODEL=2 , DEVNO=(420,8) 


RDEVICE DEVTYPE=1403 , DEVNO=(@0E, 1) 
RDEVICE DEVTYPE=1403 ,DEVNO=(10E, 1) 
RDEVICE DEVTYPE=1403 ,DEVNO=(20E, 1) 
RDEVICE DEVTYPE=1403 ,DEVNO=(30E, 1) 
RDEVICE DEVTYPE=1403 , DEVNO=(40E, 1) 
RDEVICE DEVTYPE=1403 ,DEVNO=(50E, 1) 
RDEVICE DEVTYPE=1403 , DEVNO=(60E,1) 


RDEVICE DEVTYPE=1403 , DEVNO=(O0F , 1) 
RDEVICE DEVTYPE=1403 ,DEVNO=(10F ,1) 
RDEVICE DEVTYPE=1403 ,DEVNO=(20F ,1) 
RDEVICE DEVTYPE=1403 , DEVNO=(30F , 1) 
RDEVICE DEVTYPE=1403 ,DEVNO=(40F ,1) 
RDEVICE DEVTYPE=1403 ,DEVNO=(50F ,1) 
RDEVICE DEVTYPE=1403 , DEVNO=(60F ,1) 
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* 


* 


* 


* 


* 


RDEVICE DEVTYPE=2540R, DEVNO=(06C, 1) 
RDEVICE DEVTYPE=2540R,DEVNO=(16C, 1) 
RDEVICE DEVTYPE=2540R, DEVNO=(26C, 1) 
RDEVICE DEVTYPE=2540R, DEVNO=(30C, 1) 
RDEVICE DEVTYPE=2540R, DEVNO=(46C, 1) 
RDEVICE DEVTYPE=2540R, DEVNO=(56C, 1) 
RDEVICE DEVTYPE=2540R, DEVNO=(60C, 1) 


RDEVICE DEVTYPE=2540P , DEVNO=(06D, 1) 
RDEVICE DEVTYPE=2540P , DEVNO=(16D, 1) 
RDEVICE DEVTYPE=2540P , DEVNO=(20D, 1) 
RDEVICE DEVTYPE=2540P , DEVNO=(30D, 1) 
RDEVICE DEVTYPE=2540P , DEVNO=(40D, 1) 
RDEVICE DEVTYPE=2540P , DEVNO=(50D, 1) 
RDEVICE DEVTYPE=2540P , DEVNO=(60D, 1) 


RDEVICE DEVTYPE=3211 ,DEVNO=(602, 1) 
RDEVICE DEVTYPE=3211,DEVNO=(102, 1) 
RDEVICE DEVTYPE=3211 ,DEVNO=(202, 1) 
RDEVICE DEVTYPE=3211 ,DEVNO=(302, 1) 
RDEVICE DEVTYPE=3211,DEVNO=(402, 1) 


RDEVICE DEVTYPE=3203 ,MODEL=5 , DEVNO=(003, 1) 
RDEVICE DEVTYPE=3203 ,MODEL=5 ,DEVNO=(103, 1) 
RDEVICE DEVTYPE=3203 ,MODEL=5 , DEVNO=(203, 1) 
RDEVICE DEVTYPE=3203 ,MODEL=5 , DEVNO=(303, 1) 


RDEVICE DEVTYPE=3278 ,MODEL=2 , DEVNO=(040,8) 
RDEVICE DEVTYPE=3278 ,MODEL=2 ,DEVNO=(140,8) 
RDEVICE DEVTYPE=3278 ,MODEL=2 , DEVNO=(240,8) 
RDEVICE DEVTYPE=3278 ,MODEL=2 , DEVNO=(340,8) 
RDEVICE DEVTYPE=3278 ,MODEL=2 ,DEVNO=(440,8) 
RDEVICE DEVTYPE=3278 ,MODEL=2 , DEVNO=(540,8) 
RDEVICE DEVTYPE=3278 ,MODEL=2 ,DEVNO=(640,8) 


RDEVICE DEVTYPE=3278 ,MODEL=5 , DEVNO=(088,8) 
RDEVICE DEVTYPE=3278 ,MODEL=5 , DEVNO=(188,8) 
RDEVICE DEVTYPE=3278 ,MODEL=5 , DEVNO=(288,8) 
RDEVICE DEVTYPE=3278 ,MODEL=5 , DEVNO=(388,8) 
RDEVICE DEVTYPE=3278 ,MODEL=5 ,DEVNO=(488,8) 
RDEVICE DEVTYPE=3278 ,MODEL=5 , DEYNO=(588,8) 


RDEVICE DEVTYPE=3290 , DEVNO=(098,8) 
RDEVICE DEVTYPE=3290,DEVNO=(198,8) 
RDEVICE DEVTYPE=3290, DEVNO=(298,8) 
RDEVICE DEVTYPE=3290, DEVNO=(398,8) 
RDEVICE DEVTYPE=3290, DEVNO=(498,8) 
RDEVICE DEVTYPE=3290 ,DEVNO=(598,8) 


RDEVICE DEVTYPE=3505,CLASS=A, DEVNO=(012,1) 


RDEVICE DEVTYPE=3505,CLASS=A,DEVNO=(112,1) | 


RDEVICE DEVTYPE=3505 ,CLASS=A, DEVNO=(212, 1) 
RDEVICE DEVTYPE=3505 ,CLASS=A, DEVNO=(312, 1) 
RDEVICE DEVTYPE=3505 ,CLASS=A , DEVNO=(412, 1) 


RDEVICE DEVTYPE=3525 ,CLASS=A, DEVNO=(013, 1) 
RDEVICE DEVTYPE=3525,CLASS=A, DEVNO=(113,1) 
RDEVICE DEVTYPE=3525 ,CLASS=A, DEVNO=(213, 1) 
RDEVICE DEVTYPE=3525 ,CLASS=A, DEVNO=(313, 1) 
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RDEVICE DEVTYPE=3525,CLASS=A, DEVNO=(413,1) 
* 

RDEVICE DEVTYPE=3480 , DEVNO=(004 4) 
RDEVICE DEVTYPE=3480,DEVNO=(104 ,4) 
RDEVICE DEVTYPE=3480 , DEVNO=(204 , 4) 
RDEVICE DEVTYPE=3480 , DEVNO=(364 , 4) 
* 

RDEVICE DEVTYPE=3890 , DEVNO=(008, 4) 
RDEVICE DEVTYPE=3890 ,DEVNO=(108, 4) 
* 

RDEVICE DEVTYPE=HFGD,DEVNO=(014,4) 
RDEVICE DEVTYPE=HFGD ,DEVNO=(114,4) 


* 


EJECT 


HRHKKEKRKEKKRKEEKEREREEREKREEEEREREEREEREERERREREEARERREERRERERREERERRERETRE 


SPACE 2 
RIOGEN CONS=020,ALTCONS=(120,220,320, 
420,040, 140,240,340,440, 540,640) 
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Sample Input/Output Configuration Profile 


IOCP 


IBM supplies the following sample file with VM/XA SP. It is only a sample file, and must be tailored to your 


installation before it can be used. 


RAKKEKKEEEEKEEEREREEEREREREREEREEREEEREEREERUCKERERREREEEEREERREKE 


id Virtual Machine / System Product 5664-308 Bee 
wae Copyright (c) I BM Corporation 1988, 1989 *** 
aay Licensed Materials - Property of I BM ae* 


wave Refer to Copyright Instructions: Form G120-2083 sad 
HRRKEAKKKKCKKECREECREEKRREEREKEKEEAEEEEREREKECEAEEEAEKRRR RK 
ID MSG1='SAMPLE IOCP INPUT FILE’, 
MSG2='COMPANION TO SAMPLE HCPRIO' 


CHPID PATH=((00,0,0), (01,1,0) , (02,2,0) , (03,3,0), (04,4,0), (05,5,0), 


(06,6,0),(07,7,0)) ,TYPE=BL 
CHPID PATH=((10,8,0),(11,9,0),(12,A,0) ,(13,B,0)) ,TYPE=BL 


CHPID PATH=((14,0,1),(15,1,1),(16,2,1),(17,3,1), (20,4,1),(21,5,1), 


(22,6,1),(23,7,1)) , TYPE=BL 
CHPID PATH=((24,8,1),(25,9,1) ,(26,A,1) ,(27,B,1)) , TYPE=BL 
*IOCP 
CNTLUNIT CUNUMBR=G01,UNIT=3803 , UNITADD=((70,8)), 
PATH=(60, 14) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=G02 , UNIT=3803 , UNITADD=((70,8)), 
PATH=(01,15) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=003 , UNIT=3803 ,UNITADD=((70,8)), 
PATH=(02, 16) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=004 , UNIT=3803 , UNITADD=((70,8)), 
PATH=(03,17) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=005 ,UNIT=3803 ,UNITADD=((70,8)), 
PATH=(04,20) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=006 , UNIT=3803 , UNITADD=((70,8)), 
PATH=(05,21) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=007 , UNIT=3803 , UNITADD=((70,8)), 
PATH=(06,22) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=008, UNIT=3803 , UNITADD=((70,8)), 
PATH=(07 ,23) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=009, UNIT=3803 , UNITADD=((70,8)), 
PATH=(10,24) , PROTOCL=D , SHARED=Y 
CNTLUNIT CUNUMBR=00A, UNIT=3803 , UNITADD=((70,8)), 
PATH=(11,25) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=00B, UNIT=3803 , UNITADD=((70,8)), 
PATH=(12,26) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=06C , UNIT=3803 , UNITADD=((70,8)), 
PATH=(13,27) , PROTOCL=D,, SHARED=Y 
*IOCP 
CNTLUNIT CUNUMBR=0GD ,,UNIT=3803 , UNITADD=((80,8)), 
PATH=(00,14) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=00E , UNIT=3803 , UNITADD=((80,8)), 
PATH=(01,15) , PROTOCL=D , SHARED=Y 
CNTLUNIT CUNUMBR=O0F ,UNIT=3803, UNITADD=((80,8)), 
PATH=(02, 16) , PROTOCL=D,, SHARED=Y 
CNTLUNIT CUNUMBR=010,UNIT=3803 , UNI TADD=((80,8)), 
PATH=(03,17) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=011,UNIT=3803 , UNITADD=((80,8)), 
PATH=(04,20) , PROTOCL=D,, SHARED=Y 
CNTLUNIT CUNUMBR=012 ,UNIT=3803 , UNITADD=((80,8)), 
PATH=(05,21) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=013 ,UNIT=3803 , UNITADD=((80,8)), 
PATH=(06,22) , PROTOCL=D, SHARED=Y 
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CNTLUNIT CUNUMBR=014 , UNIT=3803 ,UNITADD=((80,8)), 
PATH=(07 ,23) , PROTOCL=D, SHARED=Y 

CNTLUNIT CUNUMBR=015,UNIT=3803 , UNI TADD=((80,8)), 
PATH=(10,24) , PROTOCL=D, SHARED=Y 

CNTLUNIT CUNUMBR=016 , UNIT=3803 , UNITADD=((80,8)), 
PATH=(11,25) , PROTOCL=D, SHARED=Y 

CNTLUNIT CUNUMBR=017 , UNIT=3803 , UNITADD=((80,8)), 
PATH=(12,26) , PROTOCL=D, SHARED=Y 

CNTLUNIT CUNUMBR=018 ,UNIT=3803 , UNITADD=( (80,8) ), 
'  PATH=(13,27) , PROTOCL=D, SHARED=Y 


CNTLUNIT CUNUMBR=019,UNIT=3830,UNITADD=((50,8)), 
PATH=(00,14) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=01A,UNIT=3830,UNITADD=((50,8)), 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=01B, UNIT=3830, UNITADD=((50,8)), 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=01C ,UNIT=3830, UNITADD=((50,8)), 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=01D, UNIT=3830,UNITADD=((50,8)), 
PATH=(04,20) ,PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=01E , UNIT=3830,UNITADD=((50,8)), 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=01F ,UNIT=3830, UNITADD=((50,8)), 
PATH=(06,22) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=020, UNIT=3830,UNITADD=((50,8)), 
PATH=(07 ,23) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=021, UNIT=3830, UNI TADD=((50,8)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=022 , UNIT=3830,UNITADD=((50,8)), 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=023 , UNIT=3830, UNITADD=((50,8)), 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=024 , UNIT=3830, UNITADD=( (50,8) ), 
PATH=(13,27) , PROTOCL=D, SHARED=N 


CNTLUNIT CUNUMBR=025 , UNIT=3830,UNITADD=((58,8)), 
PATH=(00,14) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=026,UNIT=3830,UNITADD=((58,8)), 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=027 , UNIT=3830, UNITADD=((58,8)), 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=028 ,UNIT=3830, UNITADD=((58,8)), 
PATH=(03, 17) ,PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=029, UNIT=3830,UNITADD=((58,8)), 
PATH=(04,20) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=02A,UNIT=3830,UNITADD=((58,8)), 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=02B,UNIT=3830,UNITADD=((58,8)), 
PATH=(06,22) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=02C ,UNIT=3830, UNITADD=( (58,8) ), 
PATH=(07 ,23) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=02D,UNIT=3830, UNI TADD=((58,8)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=02E ,UNIT=3830, UNI TADD=((58,8)), 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=02F ,UNIT=3830,UNITADD=((58,8)), 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=030,UNIT=3830,UNITADD=((58,8)), 
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PATH=(13,27) , PROTOCL=D, SHARED=N 


* 


CNTLUNIT CUNUMBR=031,UNIT=3830, UNITADD=((C0,8)), - 
PATH=(60,14) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=032 ,UNIT=3830,UNITADD=((CO,8)), " 
PATH=(01,15) ,PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=033 ,UNIT=3830,UNITADD=((C0,8)), - 
PATH=(62,16) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=034 , UNIT=3830,UNITADD=((CO,8)), : 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=035,UNIT=3830,UNITADD=((C0,8)), " 
PATH=(04,20) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=036,UNIT=3830, UNITADD=((CO,8)), " 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=037 , UNIT=3830,UNITADD=((C0,8)), . 
PATH=(@6,22) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=038, UNIT=3830, UNITADD=((CO,8)), : 
PATH=(07 ,23) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=039 , UNIT=3830 , UNITADD=((C0,8)), sg 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=03A, UNIT=3830,UNITADD=((CO,8)), 3 
PATH=(11,25) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=03B,UNIT=3830,UNITADD=((C0,8)), e 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=03C , UNIT=3830, UNI TADD=((CO,8)), * 
PATH=(13,27) , PROTOCL=D, SHARED=N 
* 
ENTLUNIT CUNUMBR=03D, UNIT=3830, UNITADD=((48,8)), . 
PATH=(00, 14) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=03E,UNIT=3830,UNITADD=((48,8)), _ 
PATH=(01, 15) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=03F , UNIT=3830, UNITADD=((48,8)), 7 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=040,UNIT=3830, UNITADD=((48,8)), . 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=041 ,UNIT=3830,UNITADD=((48,8)), * 
PATH=(04,20) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=042 , UNIT=3830,UNITADD=((48,8)), . 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=043 ,UNIT=3830,UNITADD=((48,8)), 
PATH=(06,22) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=044,UNIT=3830,UNITADD=((48,8)), e 
PATH=(07,23) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=045, UNIT=3830, UNI TADD=((48,8)), “ 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=046 , UNIT=3830, UNITADD=((48,8)), ? 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=047 , UNIT=3830,UNITADD=((48,8)), : 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=048, UNIT=3830,UNITADD=((48,8)), * 
PATH=(13,27) ,PROTOCL=D, SHARED=N 
* 
CNTLUNIT CUNUMBR=049, UNIT=3830,UNITADD=((30,8)), i 
PATH=(00,14) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=04A, UNIT=3830, UNI TADD=((30,8)), | i 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=04B, UNIT=3830,UNITADD=((30,8)), i 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=04C, UNIT=3830,UNITADD=((30,8)), * 


PATH=(03,17) , PROTOCL=D, SHARED=N 
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CNTLUNIT CUNUMBR=04D , UNIT=3830,UNITADD=((30,8) ), 
PATH=(04,20) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=04E ,UNIT=3830 ,UNITADD=((30,8)), 
PATH=(05,21) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=04F , UNIT=3830, UNITADD=((30,8)), 
PATH=(06,22) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=050, UNIT=3830, UNITADD=((30,8)), 
PATH=(07 ,23) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=051,UNIT=3830, UNITADD=((30,8)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=052 ,UNIT=3830,UNITADD=((30,8)), 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=053 , UNIT=3830,UNITADD=((30,8)), 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=054 , UNIT=3830 , UNITADD=((30,8)), 
PATH=(13,27) , PROTOCL=D , SHARED=N 
* 
CNTLUNIT CUNUMBR=055, UNIT=3880 , UNITADD=( (60,8) ), 
PATH=(@0,14) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=056 , UNIT=3880, UNI TADD=((60,8)), 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=057 , UNIT=3880 , UNI TADD=((60,8)), 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=058 , UNIT=3880, UNI TADD=((60,8)), 
PATH=(03, 17) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=059, UNIT=3880, UNI TADD=( (60,8) ), 
PATH=(04,20) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=05A,UNIT=3880 ,UNITADD=((60,8)), 
PATH=(05,21) ,PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=05B ,UNIT=3880 , UNI TADD=( (60,8) ), 
PATH=(0@6,22) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=O5C , UNIT=3880, UNITADD=((60,8)), . 
PATH=(07 ,23) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=05D, UNIT=3880, UNITADD=((60,8)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=05E ,UNIT=3880, UNITADD=( (60,8)) , 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=O5F , UNIT=3880, UNITADD=((60,8)), 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=060,UNIT=3880,UNITADD=((60,8)), 
PATH=(13,27) , PROTOCL=D , SHARED=N 


CNTLUNIT CUNUMBR=061 ,UNIT=2835 ,UNITADD=((FO,8)), 
PATH=(00, 14) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=062 , UNIT=2835 ,UNITADD=((FO,8)), 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=063,UNIT=2835 , UNI TADD=((FO,8)), 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=064 , UNIT=2835,UNITADD=((FO,8)), 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=065 , UNIT=2835, UNITADD=((FO,8)), 
PATH=(04,20) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=066 ,UNIT=2835 ,UNITADD=((FO,8)), 
PATH=(05,21) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=067 ,UNIT=2835 ,UNITADD=((FO,8)), 
| PATH=(06,22) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=068,UNIT=2835,UNITADD=((FO,8)), 
PATH=(07 ,23) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=069 , UNIT=2835,UNITADD=((FO,8)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
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CNTLUNIT CUNUMBR=06A,UNIT=2835,UNITADD=((FO,8)), * 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=06B,UNIT=2835,UNITADD=((F0,8)), * 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=06C ,UNIT=2835,UNITADD=((FO,8)), * 
PATH=(13,27) , PROTOCL=D , SHARED=N 
* 
CNTLUNIT CUNUMBR=G6D ,UNIT=2835,UNITADD=((DO,8)), * 
PATH=(60,14) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=06E ,UNIT=2835,UNITADD=((D0,8)), * 
PATH=(01, 15) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=06F ,UNIT=2835,UNITADD=((D0,8)) , * 
PATH= (02,16) ,PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=070,UNIT=2835 ,UNITADD=((D0,8)), * 
PATH=(03,17) ,PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=071,UNIT=2835,UNITADD=((D0,8)), * 
PATH=(04,20) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=072,UNIT=2835,UNITADD=((D0,8)), * 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=073,UNIT=2835,UNITADD=((D0,8)), * 
PATH=(06,22) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=074 ,UNIT=2835,UNITADD=((D0,8)) , * 
PATH=(07 ,23) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=075 ,UNIT=2835 ,UNITADD=((D0,8)), * 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=076,UNIT=2835,UNITADD=((D0,8)), * 
PATH=(11,25) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=077 ,UNIT=2835,UNITADD=((D0,8)), * 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=078, UNIT=2835,UNITADD=((D0,8)), * 
PATH=(13,27) , PROTOCL=D, SHARED=N 
* 
CNTLUNIT CUNUMBR=079,UNIT=3800,UNITADD=((18,1)), * 
PATH=(00,14) ,PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=07A ,UNIT=3800,UNITADD=((18,1)), * 
PATH=(@1,15) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=07B,UNIT=3800,UNITADD=((18,1)), * 
PATH=(02, 16) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=07C ,UNIT=3800,UNITADD=((18,1)), * 
| PATH=(@3,17) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=07D,UNIT=3800,UNITADD=((18,1)), * 
PATH=(04,20) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=07E ,UNIT=3800 ,UNITADD=((18,1)), * 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=07F , UNIT=3800,UNITADD=((18,1)), * 
PATH=(06,22) , PROTOCL=D , SHARED=N 
* 
CNTLUNIT CUNUMBR=080,UNIT=3274,UNITADD=((20,8)), * 
PATH=(07 ,23) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=081,UNIT=3274,UNITADD=((20,8)), * 
PATH=(10,24) , PROTOCL=D , SHARED=Y 
CNTLUNIT CUNUMBR=082 ,UNIT=3274,UNITADD=((20,8)), * 
PATH=(11,25) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=083 ,UNIT=3274,UNITADD=((20,8)) * 
PATH=(12,26) , PROTOCL=D , SHARED=Y 
CNTLUNIT CUNUMBR=084 , UNIT=3274, UNITADD=((20,8)) , * 


PATH=(13,27) , PROTOCL=D, SHARED=Y 


* 


CNTLUNIT CUNUMBR=085 ,UNIT=2821,UNITADD=((0C,4)), . 3 
PATH=(00,14) , PROTOCL=D, SHARED=N 
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CNTLUNIT CUNUMBR=086 ,UNIT=2821,UNITADD=((0C,4)), 
PATH=(01,15) ,PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=087 , UNIT=2821,UNITADD=((0C,4)), 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=088 , UNIT=2821 ,UNITADD=((0C,4)), 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=089 , UNIT=2821,UNITADD=((0C,4)), 
PATH=(04,20) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=08A,UNIT=2821,UNITADD=((@C,4)), 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=08B ,UNIT=2821 ,UNITADD=((0C,4)), 
PATH=(06,22) , PROTOCL=D, SHARED=N 


CNTLUNIT CUNUMBR=Q8C , UNIT=3811,UNITADD=((02,1)), 
PATH=(07 ,23) , PROTOCL=D,, SHARED=N 
CNTLUNIT CUNUMBR=08D,UNIT=3811,UNITADD=((02,1)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=08E ,UNIT=3811,UNITADD=((02,1)), 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=08F ,UNIT=3811,UNITADD=((02,1)), 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=090,UNIT=3811,UNITADD=((02,1)), 
PATH=(13,27) , PROTOCL=D, SHARED=N 


CNTLUNIT CUNUMBR=091 ,UNIT=3274 , UNITADD=((40,8)), 
PATH=(60, 14) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=092 , UNIT=3274 , UNITADD=((40,8)), 
PATH=(01,15) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=093 ,UNIT=3274 ,UNITADD=((40,8)), 
PATH=(02,16) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=094 ,UNIT=3274 ,UNITADD=((40,8)), 
PATH=(03,17) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=095 , UNIT=3274 , UNITADD=( (40,8) ), 
PATH=(04,20) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=096,UNIT=3274 , UNITADD=((40,8)), 
PATH=(05,21) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=097 , UNIT=3274 , UNITADD=((40,8)), 
PATH=(06,22) , PROTOCL=D , SHARED=Y 


CNTLUNIT CUNUMBR=098 , UNIT=3505 ,UNITADD=((12,2)), 
‘PATH=(07 ,23) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=099 , UNIT=3505 ,UNITADD=((12,2)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=09A, UNIT=3505, UNITADD=((12,2)), 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=09B, UNIT=3505 , UNITADD=((12,2)), 
PATH=(12,26) ,PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=09C ,UNIT=3505 , UNITADD=((12,2)), 
PATH=(13,27) , PROTOCL=D, SHARED=N 


CNTLUNIT CUNUMBR=09D , UNIT=3880, UNI TADD=( (68,8) ), 
PATH=(00, 14) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=09E , UNIT=3880 , UNITADD=( (68,8) ), 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=G69F , UNIT=3880, UNI TADD=((68,8)), 
PATH=(02, 16) ,PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=0A0, UNIT=3880, UNITADD=( (68,8) ), 
PATH=(03,17) ,PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=0A1 ,UNIT=3880, UNITADD=((68,8)), 
PATH=(04,20) , PROTOCL=D , SHARED=N 
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CNTLUNIT CUNUMBR=0A2,UNIT=3880,UNITADD=((68,8)),  * 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=0A3,UNIT=3880, UNITADD=((68,8)), * 
PATH=(06,22) , PROTOCL=D, SHARED=N 
r 
CNTLUNIT CUNUMBR=0A4,UNIT=3880,UNITADD=((90,8)), _ * 
PATH=(07,23) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=0A5,UNIT=3880,UNITADD=((90,8)), . 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=0A6,UNIT=3880,UNITADD=((90,8)), * 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=0A7 ,UNIT=3880,UNITADD=((90,8)), * 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=0A8, UNIT=3880,UNITADD=((90,8)), * 
PATH=(13,27) , PROTOCL=D, SHARED=N 
* 
CNTLUNIT CUNUMBR=0A9,UNIT=3880,UNITADD=((38,8)), * 
PATH=(00, 14) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=OAA, UNIT=3880, UNITADD=((38,8)), * 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=OAB, UNIT=3880,UNITADD=((38,8)), * 
PATH=(02, 16) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=OAC, UNIT=3880,UNITADD=((38,8)), * 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=GQAD, UNIT=3880, UNITADD=((38,8)), * 
PATH=(04,20) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=OAE,UNIT=3880 , UNITADD=( (38,8)), * 
| PATH=(05,21) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=OAF , UNIT=3880, UNITADD=((38,8)), - 
PATH=(06,22) , PROTOCL=D, SHARED=N 
* 
CNTLUNIT CUNUMBR=080,UNIT=3880 ,UNITADD=((A0,8)), * 
PATH=(07 ,23) , PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=0B1, UNIT=3880,UNITADD=((A0,8)), * 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=0B2,UNIT=3880 ,UNITADD=((A0,8)), * 


PATH=(11,25) , PROTOCL=D, SHARED=N 


~ CNTLUNIT CUNUMBR=0B3,UNIT=3880,UNITADD=((AQ,8)), * 


PATH=(12,26) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=0B4 , UNIT=3880, UNITADD=((A0,8)), ig 
PATH=(13,27) , PROTOCL=D, SHARED=N 


* 


CNTLUNIT CUNUMBR=0B5 , UNIT=3203 ,UNITADD=((03,1)), . 
PATH=(60,14) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=0B6,UNIT=3203 ,UNITADD=((03,1)), " 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=0B7 , UNIT=3203 ,UNITADD=((03,1)), * 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=0B8, UNIT=3203,UNITADD=((03,1)), ™ 
PATH=(03,17) , PROTOCL=D, SHARED=N 
* 
CNTLUNIT CUNUMBR=0B9 , UNIT=3480 ,UNITADD=((04,4)), ” 
PATH=(04,20) , PROTOCL=S , SHARED=N | 
CNTLUNIT CUNUMBR=OBA, UNIT=3480,UNITADD=((04,4)), | - 
PATH=(05,21) , PROTOCL=S , SHARED=N 
CNTLUNIT CUNUMBR=08B, UNIT=3480, UNITADD=((04,4)), . 
PATH=(06,22) , PROTOCL=S , SHARED=N 
CNTLUNIT CUNUMBR=OBC ,UNIT=3480 ,UNITADD=((04,4)), . 


PATH=(07 ,23) , PROTOCL=S , SHARED=N 


* 
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CNTLUNIT CUNUMBR=OBD, UNIT=3890, UNITADD=((08,4)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR-OBE ,UNIT=3890,UNITADD=((08,4)), 
PATH=(11,25) , PROTOCL=D , SHARED=N 
* 
CNTLUNIT CUNUMBR=OBF ,UNIT=5088, UNITADD=((14,4)), 
PATH=(12,26) ,PROTOCL=D , SHARED=N 
CNTLUNIT CUNUMBR=0CO,UNIT=5088, UNITADD=((14,4)), 
PATH=(13,27) , PROTOCL=D, SHARED=N 
* 
IODEVICE CUNUMBR=001 , UNIT=3420 , ADDRESS=(070,8) 
IODEVICE CUNUMBR=002 , UNIT=3420, ADDRESS=(170,8) 
IODEVICE CUNUMBR=003 , UNIT=3420 , ADDRESS=(276,8) 
IODEVICE CUNUMBR=004 , UNIT=3420 , ADDRESS=(370,8) 
IODEVICE CUNUMBR=005 , UNIT=3420 , ADDRESS=(470,8) 
IODEVICE CUNUMBR=006 , UNIT=3420 , ADDRESS=(570,8) 
IODEVICE CUNUMBR=007 , UNIT=3420, ADDRESS=(670,8) 
IODEVICE CUNUMBR=008 , UNIT=3420 , ADDRESS=(770,8) 
IODEVICE CUNUMBR=009 , UNIT=3420, ADDRESS=(870,8) 
IODEVICE CUNUMBR=00A,UNIT=3420, ADDRESS=(970,8) 
IODEVICE CUNUMBR=00B, UNIT=3420 , ADDRESS=(A70,8) 
TODEVICE CUNUMBR=00C , UNIT=3420 , ADDRESS=(B70,8) 


IODEVICE CUNUMBR=00D , UNIT=3420, ADDRESS=(080,8) 
IODEVICE CUNUMBR=00E , UNIT=3420 , ADDRESS=(180,8) 
IODEVICE CUNUMBR=00F , UNIT=3420 , ADDRESS=(280 ,8) 
IODEVICE CUNUMBR=010, UNIT=3420 , ADDRESS=(380,8) 
TODEVICE CUNUMBR=011 , UNIT=3420, ADDRESS=(480,8) 
IODEVICE CUNUMBR=012 , UNIT=3420, ADDRESS=(580,8) 
IODEVICE CUNUMBR=013 , UNIT=3420 , ADDRESS=(680 ,8) 
IODEVICE CUNUMBR=014 , UNIT=3420, ADDRESS=(780,8) 
IODEVICE CUNUMBR=015 , UNIT=3420 , ADDRESS=(880,8) 
IODEVICE CUNUMBR=016, UNIT=3420 , ADDRESS=(980,8) 
IODEVICE CUNUMBR=017 , UNIT=3420,, ADDRESS=(A80,8) 
IODEVICE CUNUMBR=018 , UNIT=3420 , ADDRESS=(B80,8) 


IODEVICE CUNUMBR=019 , UNIT=3330 , ADDRESS=(050,8) 
IODEVICE CUNUMBR=01A, UNIT=3330, ADDRESS=(150,8) 
IODEVICE CUNUMBR=01B, UNIT=3330, ADDRESS=(250,8) 
IODEVICE CUNUMBR=01C , UNIT=3330 , ADDRESS=(350,8) 
IODEVICE CUNUMBR=01D , UNIT=3330 , ADDRESS=(450,8) 
TODEVICE CUNUMBR=01E , UNIT=3330, ADDRESS=(550,8) 
IODEVICE CUNUMBR=01F , UNIT=3330, ADDRESS=(650,8) 
IODEVICE CUNUMBR=020 , UNIT=3330 , ADDRESS=(750,8) 
IODEVICE CUNUMBR=021 , UNIT=3330 , ADDRESS=(850,8) 
IODEVICE CUNUMBR=022 , UNIT=3330 , ADDRESS=(950,8) 
IODEVICE CUNUMBR=023 , UNIT=3330 , ADDRESS=(A50,8) 
IODEVICE CUNUMBR=024 , UNIT=3330, ADDRESS=(B50 ,8) 


IODEVICE CUNUMBR=025 , UNIT=3330 , ADDRESS=(058,8) 
TODEVICE CUNUMBR=026 , UNIT=3330, ADDRESS=(158,8) 
IODEVICE CUNUMBR=027 , UNIT=3330, ADDRESS=(258,8) 
IODEVICE CUNUMBR=028 , UNIT=3330 , ADDRESS=(358 ,8) 
IODEVICE CUNUMBR=029 , UNIT=3330 , ADDRESS=(458,8) 
IODEVICE CUNUMBR=02A, UNIT=3330 , ADDRESS=(558,8) 
IODEVICE CUNUMBR=02B , UNIT=3330 , ADDRESS=(658,8) 
IODEVICE CUNUMBR=02C , UNIT=3330, ADDRESS=(758 ,8) 
IODEVICE CUNUMBR=02D , UNIT=3330, ADDRESS=(858 ,8) 
IODEVICE CUNUMBR=02E , UNIT=3330 , ADDRESS=(958,8) 
IODEVICE CUNUMBR=02F ,UNIT=3330 , ADDRESS=(A58,8) 
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IODEVICE CUNUMBR=030 , UNIT=3330 , ADDRESS=(B58,8) 
* 
IODEVICE CUNUMBR=031 , UNIT=3340, ADDRESS=(0CO,8) 
IODEVICE CUNUMBR=032 ,UNIT=3340 , ADDRESS=(1C0,8) 
IODEVICE CUNUMBR=033 , UNIT=3340, ADDRESS=(2C0,8) 
IODEVICE CUNUMBR=034 , UNIT=3340 , ADDRESS=(3C0,8) 
IODEVICE CUNUMBR=035 , UNIT=3340, ADDRESS=(4C0,8) 
IODEVICE CUNUMBR=036 , UNI T=3340, ADDRESS=(5CO, 8) 
IODEVICE CUNUMBR=037 , UNIT=3340, ADDRESS=(6C0,8) 
IODEVICE CUNUMBR=038, UNIT=3340, ADDRESS=(7C0,8) 
TODEVICE CUNUMBR=039 , UNIT=3340, ADDRESS=(8CO,8) 
IODEVICE CUNUMBR=03A, UNIT=3340, ADDRESS=(9C0,8) 
IODEVICE CUNUMBR=03B,UNIT=3340, ADDRESS=(ACO,8) 
IODEVICE CUNUMBR=03C , UNIT=3340 , ADDRESS=(BCO,8) 


IODEVICE CUNUMBR=03D, UNIT=3350 , ADDRESS=(048,8) 
IODEVICE CUNUMBR=03E , UNIT=3350, ADDRESS=(148,8) 
IODEVICE CUNUMBR=03F , UNIT=3350, ADDRESS=(248, 8) 
IODEVICE CUNUMBR=040 , UNIT=3350 , ADDRESS=(348,8) 
IODEVICE CUNUMBR=041 , UNIT=3350, ADDRESS=(448,8) 
IODEVICE CUNUMBR=042 , UNIT=3350, ADDRESS=(548,8) 
IODEVICE CUNUMBR=043,UNIT=3350, ADDRESS=(648, 8) 
IODEVICE CUNUMBR=044 , UNIT=3350 , ADDRESS=(748,8) 
IODEVICE CUNUMBR=045 , UNIT=3350, ADDRESS=(848,8) 
IODEVICE CUNUMBR=046, UNIT=3350, ADDRESS=(948, 8) 
IODEVICE CUNUMBR=047 , UNIT=3350 , ADDRESS=(A48, 8) 
IODEVICE CUNUMBR=048, UNIT=3350, ADDRESS=(B48, 8) 


IODEVICE CUNUMBR=049, UNIT=3350 , ADDRESS=(030,8) 
IODEVICE CUNUMBR=04A, UNIT=3350, ADDRESS=(130,8) 
IODEVICE CUNUMBR=04B, UNIT=3350 , ADDRESS=(230,8) 
IODEVICE CUNUMBR=04C, UNIT=3350, ADDRESS=(330,8) 
IODEVICE CUNUMBR=04D,UNIT=3350, ADDRESS=(430,8) 
IODEVICE CUNUMBR=04E, UNIT=3350 , ADDRESS=(530,8) 
IODEVICE CUNUMBR=04F , UNIT=3350, ADDRESS=(630,8) 
IODEVICE CUNUMBR=050, UNIT=3350, ADDRESS=(730, 8) 
IODEVICE CUNUMBR=051,UNIT=3350, ADDRESS=(830,8) 
IODEVICE CUNUMBR=052,UNIT=3350 , ADDRESS=(930,8) 
IODEVICE CUNUMBR=053, UNIT=3350, ADDRESS=(A30,8) 
IODEVICE CUNUMBR=054 , UNI T=3350 , ADDRESS=(B30,8) 


IODEVICE CUNUMBR=055, UNIT=3350 , ADDRESS=(060,8) 
IODEVICE CUNUMBR=056, UNIT=3350,ADDRESS=(160,8) 
IODEVICE CUNUMBR=057 , UNIT=3350, ADDRESS=(260,8) 
IODEVICE CUNUMBR=058, UNIT=3350 , ADDRESS=(360,8) 
IODEVICE CUNUMBR=059 , UNIT=3350, ADDRESS=(460,8) 
IODEVICE CUNUMBR=05A,UNIT=3350,ADDRESS=(560, 8) 
IODEVICE CUNUMBR=05B, UNI T=3350, ADDRESS=(660, 8) 
IODEVICE CUNUMBR=05C , UNIT=3350, ADDRESS=(760,8) 
IODEVICE CUNUMBR=05D, UNIT=3350, ADDRESS=(860,8) 
IODEVICE CUNUMBR=05E, UNIT=3350, ADDRESS=(960,8) 
IODEVICE CUNUMBR=05F , UNIT=3350 , ADDRESS=(A60,8) 
IODEVICE CUNUMBR=060 , UNI T=3350, ADDRESS=(B60, 8) 


IODEVICE CUNUMBR=061,UNIT=2305 ,ADDRESS=(OFO,8) 
IODEVICE CUNUMBR=062, UNIT=2305 , ADDRESS=(1F0,8) 
IODEVICE CUNUMBR=063 , UNIT=2305 , ADDRESS=(2F0,8) 
IODEVICE CUNUMBR=064 , UNIT=2305 , ADDRESS=(3F0,8) 
IODEVICE CUNUMBR=065 , UNIT=2305 , ADDRESS=(4F0,8) 
IODEVICE CUNUMBR=066, UNIT=2305 ,ADDRESS=(5F0,8) 
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IODEVICE CUNUMBR=067 , UNIT=2305 , ADDRESS=(6F0,8) 
IODEVICE CUNUMBR=068 , UNIT=2305 , ADDRESS=(7F0,8) 
IODEVICE CUNUMBR=069 , UNIT=2305, ADDRESS=(8F0,8) 
IODEVICE CUNUMBR=06A , UNIT=2305 , ADDRESS=(9F0,8) 
IODEVICE CUNUMBR=G6B, UNIT=2305 , ADDRESS=(AFO,8) 
IODEVICE CUNUMBR=06C , UNIT=2305 , ADDRESS=(BFO,8) 


IODEVICE CUNUMBR=06D ,UNIT=2305 , ADDRESS=(0D0,8) 
IODEVICE CUNUMBR=06E , UNIT=2305 , ADDRESS=(1D0 ,8) 
IODEVICE CUNUMBR=G6F , UNIT=2305 , ADDRESS=(2D0,8) 
IODEVICE CUNUMBR=070 ,UNIT=2305 , ADDRESS=(3D0,8) 
IODEVICE CUNUMBR=071,UNIT=2305 , ADDRESS=(4D0,8) 
IODEVICE CUNUMBR=072 , UNIT=2305 , ADDRESS=(5D0,8) 
IODEVICE CUNUMBR=073 , UNIT=2305 , ADDRESS=(6D0,8) 
IODEVICE CUNUMBR=074 , UNIT=2305 , ADDRESS=(7D0,8) 
IODEVICE CUNUMBR=075 , UNIT=2305 , ADDRESS=(8D0,8) 
IODEVICE CUNUMBR=076 ,UNIT=2305 , ADDRESS=(9D0,8) 
IODEVICE CUNUMBR=077 , UNIT=2305 , ADDRESS=(ADO ,8) 
IODEVICE CUNUMBR=078, UNIT=2305 , ADDRESS=(BD0,8) 


IODEVICE CUNUMBR=079 , UNI T=3800 , ADDRESS=(018,1) 
IODEVICE CUNUMBR=07A, UNIT=3800 , ADDRESS=(118,1) 
IODEVICE CUNUMBR=07B, UNIT=3800 , ADDRESS=(218,1) 
IODEVICE CUNUMBR=07C ,UNIT=3800 , ADDRESS=(318,1) 
TODEVICE CUNUMBR=07D , UNIT=3800 , ADDRESS=(418,1) 
IODEVICE CUNUMBR=07€ , UNIT=3860 , ADDRESS=(518, 1) 
IODEVICE CUNUMBR=07F ,UNIT=3800 , ADDRESS=(618,1) 


IODEVICE CUNUMBR=080 , UNIT=3278, ADDRESS=(020,8) 
IODEVICE CUNUMBR=081 , UNIT=3278, ADDRESS=(120,8) 
IODEVICE CUNUMBR=082 , UNIT=3278 , ADDRESS=(220,8) 
IODEVICE CUNUMBR=083 , UNIT=3278, ADDRESS=(320,8) 
IODEVICE CUNUMBR=084 , UNIT=3278 , ADDRESS=(420,8) 


IODEVICE CUNUMBR=085 , UNIT=1403 , ADDRESS=(Q0E, 1) 
IODEVICE CUNUMBR=086 ,UNIT=1403 , ADDRESS=(10E , 1) 
IODEVICE CUNUMBR=087 , UNIT=1403 , ADDRESS=(20E 1) 
IODEVICE CUNUMBR=088 , UNIT=1403 , ADDRESS=(30E, 1) 
IODEVICE CUNUMBR=089 , UNIT=1403 , ADDRESS=(40E, 1) 
IODEVICE CUNUMBR=08A ,, UNIT=1403 , ADDRESS=(50E, 1) 
IODEVICE CUNUMBR=08B , UNIT=1403 , ADDRESS=(60E, 1) 


IODEVICE CUNUMBR=085 , UNIT=1403 , ADDRESS=(OOF , 1) 
IODEVICE CUNUMBR=086 , UNIT=1403 , ADDRESS=(10F 1) 
IODEVICE CUNUMBR=087 ,UNIT=1403 , ADDRESS=(20F ,1) 
IODEVICE CUNUMBR=088 , UNIT=1403 , ADDRESS=(30F , 1) 
IODEVICE CUNUMBR=089 , UNIT=1403 , ADDRESS=(40F , 1) 
IODEVICE CUNUMBR=08A, UNIT=1403 , ADDRESS=(50F , 1) 
IODEVICE CUNUMBR=08B, UNIT=1403 , ADDRESS=(60F , 1) 


IODEVICE CUNUMBR=085 , UNIT=2540R, ADDRESS=(@O0C, 1) 
IODEVICE CUNUMBR=086 , UNIT=2540R, ADDRESS=(10C, 1) 
IODEVICE CUNUMBR=087 , UNIT=2540R, ADDRESS=(20C, 1) 
IODEVICE CUNUMBR=088 ,, UNIT=2540R, ADDRESS=(36C, 1) 
IODEVICE CUNUMBR=089 , UNIT=2540R, ADDRESS=(40C, 1) 
IODEVICE CUNUMBR=08A , UNIT=2540R , ADDRESS=(50C, 1) 
IODEVICE CUNUMBR=08B, UNIT=2540R, ADDRESS=(60C, 1) 
* 
IODEVICE CUNUMBR=085 , UNIT=2540P , ADDRESS=(@0D, 1) 
IODEVICE CUNUMBR=086 , UNIT=2540P , ADDRESS=(10D, 1) 
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IODEVICE CUNUMBR=087 , UNIT=2540P, ADDRESS=(20D, 1) 
IODEVICE CUNUMBR=088, UNIT=2540P , ADDRESS=(30D, 1) 
IODEVICE CUNUMBR=089, UNIT=2540P, ADDRESS=(40D, 1) 
IODEVICE CUNUMBR=08A, UNIT=2540P , ADDRESS=(50D, 1) 
IODEVICE CUNUMBR=08B,UNIT=2540P , ADDRESS=(60D, 1) 
* 
IODEVICE CUNUMBR=08C , UNIT=3211, ADDRESS=(002, 1) 
IODEVICE CUNUMBR=08D, UNIT=3211, ADDRESS=(102,1) 
IODEVICE CUNUMBR=O8E , UNIT=3211,ADDRESS=(202, 1) 
IODEVICE CUNUMBR=08F , UNIT=3211, ADDRESS=(302,1) 
IODEVICE CUNUMBR=090 , UNIT=3211,ADDRESS=(402, 1) 
* 
IODEVICE CUNUMBR=091 , UNIT=3278, ADDRESS=(040,8) 
IODEVICE CUNUMBR=092, UNIT=3278, ADDRESS=(140,8) 
IODEVICE CUNUMBR=093, UNIT=3278, ADDRESS=(240, 8) 
IODEVICE CUNUMBR=094, UNIT=3278, ADDRESS=(340,8) 
IODEVICE CUNUMBR=095 , UNIT=3278, ADDRESS=(440,8) 
IODEVICE CUNUMBR=096 , UNIT=3278 , ADDRESS=(540,8) 
IODEVICE CUNUMBR=097 , UNIT=3278, ADDRESS=(640,8) 
* 
IODEVICE CUNUMBR=098 , UNIT=3505 , ADDRESS=(012, 1) 
IODEVICE CUNUMBR=099 , UNIT=3505 , ADDRESS=(112,1) 
IODEVICE CUNUMBR=09A, UNIT=3505 , ADDRESS=(212, 1) 
IODEVICE CUNUMBR=09B , UNIT=3505 , ADDRESS=(312, 1) 
IODEVICE CUNUMBR=09C ,UNIT=3505 , ADDRESS=(412,1) 
* 
IODEVICE CUNUMBR=098 ,, UNIT=3525 , ADDRESS=(013, 1) 
IODEVICE CUNUMBR=099 , UNIT=3525 , ADDRESS=(113, 1) 
IODEVICE CUNUMBR=09A, UNI T=3525 , ADDRESS=(213, 1) 
IODEVICE CUNUMBR=09B, UNIT=3525 , ADDRESS=(313, 1) 
IODEVICE CUNUMBR=09C , UNIT=3525 , ADDRESS=(413, 1) 
* 
IODEVICE CUNUMBR=09D,, UNIT=3375 , ADDRESS=(068,8) 
TODEVICE CUNUMBR=09E , UNIT=3375 , ADDRESS=(168,8) 
IODEVICE CUNUMBR=09F , UNIT=3375 , ADDRESS=(268,8) 
IODEVICE CUNUMBR=0A0, UNIT=3375 , ADDRESS=(368,8) 
IODEVICE CUNUMBR=0A1 ,UNIT=3375 , ADDRESS=(468,8) 
IODEVICE CUNUMBR=0A2 , UNIT=3375 , ADDRESS=(568,8) 
IODEVICE CUNUMBR=0A3,UNIT=3375 , ADDRESS=(668,8) 
* 
IODEVICE CUNUMBR=0A4, UNIT=3375, ADDRESS=(090, 8) 
IODEVICE CUNUMBR=0A5, UNIT=3375, ADDRESS=(190, 8) 
IODEVICE CUNUMBR=0A6, UNIT=3375, ADDRESS=(290,8) 
IODEVICE CUNUMBR=0A7 , UNIT=3375, ADDRESS=(390,8) 
IODEVICE CUNUMBR=0A8,UNIT=3375 , ADDRESS=(490, 8) 
* 
IODEVICE CUNUMBR=0A9 , UNI T=3380, ADDRESS=(038,8) 
IODEVICE CUNUMBR=0AA, UNIT=3380, ADDRESS=(138,8) 
IODEVICE CUNUMBR=0AB, UNIT=3380, ADDRESS=(238,8) 
IODEVICE CUNUMBR=OAC , UNIT=3380, ADDRESS=(338,8) 
IODEVICE CUNUMBR=0AD , UNIT=3380, ADDRESS=(438,8) 
IODEVICE CUNUMBR=OAE , UNIT=3380, ADDRESS=(538,8) 
IODEVICE CUNUMBR=OAF , UNIT=3380, ADDRESS=(638, 8) 
* 
IODEVICE CUNUMBR=0B0, UNIT=3380, ADDRESS=(QA0,8) 
IODEVICE CUNUMBR=0B1 , UNIT=3380 , ADDRESS=(1A0,8) 
IODEVICE CUNUMBR=0B2 , UNIT=3380, ADDRESS=(2A0,8) 
IODEVICE CUNUMBR=0B3 , UNIT=3380, ADDRESS=(3A0,8) 
IODEVICE CUNUMBR=0B4 , UNIT=3380, ADDRESS=(4A0,8) 


* 
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IODEVICE CUNUMBR=0B5 , UNIT=3203 , ADDRESS=(003, 1) 
IODEVICE CUNUMBR=0B6 , UNIT=3203 , ADDRESS=(103,1) 
IODEVICE CUNUMBR=0B7 , UNIT=3203 , ADDRESS=(203, 1) 
IODEVICE CUNUMBR=0B8 , UNIT=3203 , ADDRESS=(303, 1) 
* 
TODEVICE CUNUMBR=0B9 , UNIT=3480 , ADDRESS=(004 , 4) 
IODEVICE CUNUMBR=OBA, UNIT=3480, ADDRESS=(104 , 4) 
IODEVICE CUNUMBR=OBB, UNIT=3480 , ADDRESS=(204 , 4) 
TODEVICE CUNUMBR=GBC , UNIT=3480, ADDRESS=(304 , 4) 
* 
IODEVICE CUNUMBR=OBD , UNIT=3890 , ADDRESS=(008, 4) 
IODEVICE CUNUMBR=OBE , UNIT=3890 , ADDRESS=(108 ,4) 
* 


* §080 UNIT 

* 
IODEVICE CUNUMBR=OBF , UNIT=HFGD,ADDRESS=(014,4) 
IODEVICE CUNUMBR=0CO, UNIT=HFGD, ADDRESS=(114,4) 


* 
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Sample Files for a 3350 Starter System 


IBM provides the following sample files with the VM/XA SP 3350 starter system: 


¢ HCPSYS ASSEMBLE for starter system 

e System directory 

e System residence DASD allocation 

¢ Minidisk maps of the system residence device. 


Sample HCPSYS ASSEMBLE for 3350 


This is only a sample file. You need to tailor it to your installation before it can be used. 


SYS TITLE 'HCPSYS5@ - HCPSYS FOR VM/XA INSTALL BUILD' 


HEKAEKKEKRKEERKEERREKEEAEEEREEREREEEEEEEEREEKEKREREREREREEEERKEERKK 


nee Virtual Machine / System Product 5664-308  *** 
wee Copyright (c) I 8M Corporation 1988, 1989 *** 
wee Licensed Materials - Property of I BM wee 


baal Refer to Copyright Instructions: Form 6120-2083 ald 


KEKKKEEKERKEKEKERERREREREREREEEREREEREREREEKERERERERREEKEREREEEE 
REEKERREERKEREREEREREREEKEREREEREREREREERERERERERERKEEREEREKRKEE 
* 


* MODULE NAME - HCPSYS 


* 


DESCRIPTIVE NAME - DEFINITION OF SYSTEM 
FUNCTION - TO DEFINE THE SYSTEM 


REGISTER CONVENTIONS - SYMBOLIC REFERENCES TO REGISTERS ARE 
OF THE FORM "RX° WHERE X IS A NUMBER 
RANGING FROM © TO 15 (SEE HCPEQUAT COPY) 


PATCH LABEL - NONE 
MODULE TYPE - DATA 


PROCESSOR - ASSEMBLER H (VERSION 2) 


MACROS - 


SYSSTORE - DEFINE SYSTEM REAL STORAGE 

SYSRES ‘- DEFINE SYSTEM RESIDENCE VOLUME 
SYSCPVOL - DEFINE SYSTEM VOLUMES 

SYSOPR - DEFINE SYSTEM OPERATOR 

SYSTIME - DEFINE THE TIME ZONE 

SYSACNT - DEFINE ACCOUNTING USERID 

SYSDUMP - DEFINE DUMP RECEIVER USERID 
SYSEREP - DEFINE EREP RECEIVER USERID 

SYSID - DEFINE SYSTEM ID'S BY PROCESSOR 
SYSUVOL - DEFINE USER VOLUMES TO BE MOUNTED 
SYSFCN - DEFINE PRIV CLASSES ASSIGNED TO CP FUNCTIONS 


* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* ATTRIBUTES - RESIDENT, DATA-ONLY 
* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* SYSEND - END SYSTEM GENERATION 
* 
* 
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HCPSYS ASSEMBLE (3350) 


* GENERAL COMMENTS - THIS MODULE IS THE USER'S RESPONSIBILITY. 
* 


RREKKKEKEEKKEEEKEEEEEREKREEEEEEEREEEEEEEEEREREREEREEEEREEERERREREREERERERER 


SPACE 1 


* THE SYSTEM DEFINITION MACROS SYSSTORE, SYSRES, SYSCPVOL, 
* SYSOPR, AND SYSTIME, ARE CODED HERE, IN ANY ORDER 


SPACE 1 

SYSSTORE RMSIZE=32M, VRSIZE=8M, VRFREE=256 

SYSRES SYSVOL=XASRES, 
SYSRES=123 , SYSTYPE=3350, 
SYSNUC=003, 
SYSCKP=(013,2), 
SYSWRM=(015,2) 

SYSTIME ZONE=5,LOC=WEST , ID=EST 

SYSOPR SYSOPER=OPERATOR 

SYSCPVOL XASRES , XASERV , XAPOO1 , XAPOOZ, 


DRUMO1 , DRUMO2Z , DRUMO3 , DRUMO4 , DRUMO5 , DRUMO6 , DRUMO7 , 
PAGOO1 , PAGCO2 , PAGOO3 , PAGGO4 , PAGOO5 , PAGGO6 , PAGO07 , 


SPLO01, SPLOOZ , SPLOO3 , SPLO04 , SPLOO5 , SPLO06, SPLGO7 


_ SPACE 1 


* IN ANY 


ORDER 

SPACE 1 

SYSID DEFAULT=INSTTST, (3081A, 3081, 16000) 
SYSACNT USERID=DISKACNT 

SYSDUMP USERID=OPERATNS 

SYSEREP USERID=EREP 


+ + £ 


SYSUVOL USRPO1 , USRPO2 , USRPO3 , USRPO4 , USRPO5, USRPO6, USRPO7 ,* 


USRPO8, USRPO9 
SYSFCN OPER=A,CPRD=CE,CPWT=C, SERV=F ,DFLT=G 
SPACE 1 


SPACE 1 
SYSEND 


“7 


746 Installation and Service 


EE ee Ee ______ | ___ ee ___ _ o_o  e  —  — — ————e— 


USER DIRECT (3350) 


Sample Directory for a 3350 


This is only a sample file. You need to tailor it to your installation before it can be used. 
KEKKAKEKEREKRECKEEREREKERKREKEEEEEREREEREEEEKEREERERERRAEREREKER 


* COPYRIGHT - 5664-308 - (c) COPYRIGHT IBM CORP.- 1988, 1989 * 
* LICENSED MATERIAL - PROGRAM PROPERTY OF IBM * 
. SEE COPYRIGHT INSTRUCTIONS, 6120-2083 ig 


RAEKKEREEKEREREEEEKREREEERREREEREEERREEEREREREEREREERRERREREEEIKE 
HEKRREEKRKEREKREEREREREREREEREERREEREREREEERREEEEERREERERREEEREEES 


3350 SYSTEM VM/XA SYSTEM PRODUCT DIRECTORY 

THE ADDRESSES 123, 124, AND 125 ARE VIRTUAL ADDRESSES. 

THE ADDRESS 123 IS CRITICAL SINCE IT IS USED IN HCPSYS AND 
THE DIRECTORY. IF YOU WANT TO CHANGE IT, REMEMBER IT MUST 
BE CHANGED IN HCPSYS, THE 'DIRECTORY' STATEMENT BELOW, 

AND IN THE 'MDISK' STATEMENTS FOR THE USERID ‘MAINT’. 
NOTE: REMEMBER THESE ARE ONLY VIRTUAL ADDRESSES NOT REAL 
ADDRESSES, SO THERE IS NO NEED TO CHANGE THEM TO MATCH 
YOUR HARDWARE ADDRESSES. 


THIS DIRECTORY MUST BE MODIFIED IF MDISK PASSWORDS ARE TO 
BE SPECIFIED. WITHOUT MDISK PASSWORDS, MDISKS CANNOT BE 

SHARED USING THE 'CP LINK' COMMAND. A SAMPLE USER ENTRY 

FOLLOWS: (NOTE ONLY THE MDISK STATEMENT) 


USER ANYONE SOMEPASS 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 2277277 
IPL 190 
CONSOLE O1F 3215 
SPOOL OGC 2540 READER A 
SPOOL QOD 2540 PUNCH A 
SPOOL GOE 1403 A 
*====>  MDISK 999 33XX XXX YYY ZZZZZZ MR RPASS WPASS MPASS 


+ ¢ £¢ + £ SF + F£ + F FF FE + F&F FF F F SF HF FF FE HF F 


t+ + + + €& €& + * + FF FH HF HF FE HF FHF He HF FE HF HF HF F He HF FH HF HF HF HF HR He F 


* 

* WHERE: RPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 

* READ ONLY MODE. 

* WPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 

* WRITE MODE. 

* MPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 

* MULTI-WRITE MODE. 

* 

* NOTE: EACH PASSWORD MAY BE 1-8 CHARACTERS IN LENGTH. 

¥* 
KEKE KKK RRR 
* * 
* Following is a sample user entry and a brief description * 
* of each entry. A more detailed description may be found * 
* by referencing the VM/XA System Product Planning and : 
* Administration manual. * 
* * 
= USER CMS1 abc123 3M 32M G * 
. - Userid is CMS1 " 
~ - Logon password is abcl23 * 
” - At logon time, virtual storage will equal 3M * 
* - Maximum storage that may be defined equals 32M * 
= - Privilege class is G ~ 
* * 
* AUTOLOG AUTOLOG1 OP1 MAINT * 
* * 


- Allows user CMS1 to be autolog'd by AUTOLOGI, 
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Cte Ne a te ee ee a a Ln Ee ee hr lr _.____ So ________ a  — ———— _...  eEe er 


USER DIRECT (3350) 


OP1, and MAINT 


ACCOUNT ACT4 CMSTST 
- Time used by CMS1 will be charged to account ACT4 
- Printed output will be sent to distribution CMSTST 


IPL CMS 
- Will cause automatic IPL of named save system of 
CMS 


CONSOLE 609 3215 
- Defines virtual machines console as a 3215 at a 
virtual address of 009 


SPCOL OOC 2540 READER A 
SPOOL 60D 2540 PUNCH A 
SPOOL GOE 1403 A 
- Defines virtual unit record devices of reader, 
punch, and printer with a spooling class of '‘A' 


LINK MAINT 190 190 RR 
- Allows read access to minidisk 190 of user ‘MAINT' 


LINK MAINT 19E 19E RR 
- Allows read access to minidisk 19E of user ‘MAINT’ 


LINK MAINT 19D 19D RR 
- Allows read access to minidisk 19d of user 'MAINT' 


MDISK 999 3350 236 022 CPPACK WR RPASS WPASS 

- Defines minidisk with a virtual address of 999 

- Specifies that the minidisk resides on a real 3350 

- Minidisk starts at cylinder 236 

- Mdisk is 22 cylinders in size (starting at cyl 236 

- The real volume seria? number is ‘CPPACK' 

- Mdisk is to be accessed in write mode if no other 
user has write access. Alternate access read-only 

- RPASS is the required password for another user to 
link to this minidisk in read mode 

- WPASS is the required password for another user to 
link to this minidisk in write mode 


+ ¢ + *¢ € + ¢ * &€ & & He * HF SH SF +H HF HF HF HF SF He SF HH SF HF HF OF FF FHF SF HF HF FF HF HF F OF 4H HF 
+ + + + * + + * FF HH HH FF He + F HF F HF HF HF HF HF HF F HF FH HH SF HF SF HF HH HF SF HF HF HF HH HF HF F 


RRREEREREEEEEREEERERERKREREREREREERERERKEREREEREEEERERKEKKRKKKKE 
* 

* 

* 

DIRECTORY 123 3350 XASRES 

* 
HKAKEKKKEKEEKREREEREKKEREKRERERERKREEREREREEKREREEEEKEEEEREKKERRRKKEE 
* SYSTEM RESERVED AREAS NOT FOR MINIDISKS * 
RHKAKHRRRREEREREREEE ERE REREREREREERREREREREEEEREEEEREERERERERERKEE 
* 


USER $ALLOC$ NOLOG 

MDISK AQ1 3350 060 001 XASRES 
MDISK BQ1 3350 000 001-XASERV 
MDISK C01 3350 600 001 XAPOO1 
MDISK DO1 3350 600 001 XAPO02 


¥ 


USER $DIRECT$ NOLOG 


ADA A 
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USER DIRECT (3350) 


MDISK AQ4 3350 001 002 XASRES R 
* 

USER $CP-NUC$ NOLOG 

MDISK AO9 3350 003 010 XASRES R 
* 


USER $SYSCKP$ NOLOG 

MDISK AQ6 3350 013 002 XASRES R 
* 

USER $SYSWRM$ NOLOG 

MDISK AOQ7 3350 015 002 XASRES R 
* 


USER $PAGE$ NOLOG 

MDISK AO3 3350 017 025 XASRES R 
* 

USER $SPOOL$ NOLOG 

MDISK BO1 3350 042 060 XASRES R 
* 


USER $T-DISK$ NOLOG 
MDISK BQ1 3350 306 020 XASRES R 


* 
HK AKKKKKEKKEREEEKKEKERREREREKKEEEEEEREEKEEREERERERERREREEREREEE 
* CMS USERIDS * 
REKREKEKERKEREEREREREKEREREEEEREREEREEKEEEEREREREERERERREREREREEKRREKEER 
* 


USER CMS1 NOLOG 3M 32M G 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT4 CMSTST 

IPL CMS 

CONSOLE 009 3215 

SPOOL OOC 2540 READER A 
SPOOL OGD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 


* 
KREEKREREEKEKKRERKREEREEEREEEREREREEEKEEREEEEEEREREERRERKEEREEEEEERERERERER 
* PROP LOGICAL OPERATOR * 
HHEKKKKKEKKEKEKEAKREREEEEEEEEREERA EERE EERREREEEEEEREEEEEEKEKERE 
* 


USER LGLOPR NOLOG 512K 16M ABCDEG 
ACCOUNT ACT1 PROP 
IPL CMS 

CONSOLE 009 3215 

SPOOL OOC 2540 READER A 

SPOOL GOD 2540 PUNCH A 

SPOOL GOE 1403 A 

MDISK 191 3350 253 001 XASRES WR 
LINK MAINT 194 194 RR 

LINK MAINT 190 190 RR 

LINK OPERATOR 191 291 RR 


* 
KEKEKEKEKRAEREEAKRRERERERREREKEEKEREEREEEEKEEKERREREREREEEERRERERE 
* SYSTEM RELATED USERIDS * 
KEREREREKEKEKEREERERERREEREKERERRERERKREERREEREEEEREEKEKEREEREEREEE 
* 


USER MAINT NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 
IPL 190 
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USER DIRECT (3350) 


NAMESAVE GCS 

NAMESAVE VTAM 

NAMESAVE HELP 

NAMESAVE INSTHELP 

CONSOLE 009 3215 T 

SPOOL O@C 2540 READER * 

SPOOL 00D 2540 PUNCH A 

SPOOL GOE 1403 A 

MDISK 123 3350 060 555 XASRES 
MDISK 124 3350 000 555 XAPGQ1 
MDISK 125 3350 600 555 XASERV 
MDISK 126 3350 000 555 XAPO02 


MDISK 191 3350 326 039 XASRES 
MDISK 193 3350 414 060 XASRES 
MDISK 194 3350 001 665 XASERV 
MDISK 201 3350 066 028 XASERV 


MDISK 292 3350 094 025 XASERV 
MDISK 392 3350 119 025 XASERV 
MDISK 492 3350 157 013 XASERV 
MDISK 692 3350 144 013 XASERV 
MDISK 593 3350 170 113 XASERV 
MDISK 594 3350 406 075 XAPGO2 


MDISK 295 3350 474 018 XASRES 
MDISK 395 3350 512 013 XASRES 
MDISK 495 3350 357 007 XASERV 
MDISK 592 3350 344 013 XASERV 
MDISK 892 3350 364 007 XASERV 
MDISK 491 3350 334 010 XASERV 
MDISK 293 3350 371 175 XASERV 
MDISK 294 3350 164 150 XAPQ01 
MDISK 393 3350 326 080 XAPG02 
MDISK 394 3350 001 163 XAPOO1 
MDISK 19C 3350 256 050 XASRES 
MDISK 49C 3350 481 050 XAP002 


MDISK 190 3350 
MDISK 791 3350 
MDISK 89E 3350 102 613 XASRES 
MDISK 5E5 3350 115 007 XASRES 
MDISK 896 3350 227 013 XASRES 
MDISK 895 3350 240 013 XASRES 
MDISK 19E 3350 314 055 XAPO01 
MDISK 19D 3350 284 050 XASERV 


123 074 XASRES 
197 015 XASRES 


MDISK 291 3350 369 019 XAPG01 
MDISK 391 3350 388 019 XAPOO1 
MDISK 591 3350 001 119 XAPGQ2 
MDISK 691 3350 120 138 XAP002 
MDISK 49D 3350 500 050 XAP001 
MDISK 501 3350 481 003 XAPOO1 
MDISK 595 3350 484 016 XAPO01 
* 

MDISK 490 3350 407 074 XAPOO1 
MDISK 423 3350 272 013 XAPOQQ2 
MDISK 596 3350 285 025 XAPO02 


730 
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MW RMAINT WMAINT 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW RCMSAUX WCMSAUX MCMSAUX 
MCPAUX 


MW RCPAUX WCPAUX 


MW ALL 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW 
MW 
MW 


MMAINT 


USER DIRECT (3350) 


MDISK 59E 3350 310 013 XAPOQ02 MW 
* 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36E 3350 323 603 XAPOO2 RR RPVM WPVM = MPVM 
LINK RSCS 191 499 MW 

* 

USER CMSBATCH NOLOG 1M 2M G 
ACCOUNT 3 SYSTEM 
OPTION ACCT 
IPL CMS PARM AUTOCR 
CONSOLE 609 3215 
SPOOL OC 2540 READER * 

SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 196 190 RR 
MDISK 195 3350 254 002 XASRES MR RBATCH WBATCH MBATCH 
* 
USER GCS NOLOG 16M 16M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT GCS RECVM 
IPL GCS 
NAMESAVE GCS 
CONSOLE 669 3215 | 
SPOOL OC 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL OE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19D 19D RR 
LINK MAINT 595 595 
LINK MAINT 59E 59E 
MDISK 191 3350 223 604 XASRES MR RGCS WGCS MGCS 

* 

USER SYSMAINT NOLOG 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 
IPL CMS 
CONSOLE @09 3215 T 
SPOOL @@C 2540 READER * 

SPOOL GOD 2540 PUNCH A 
SPOOL G9E 1403 A 

LINK MAINT 123 123 MW 

LINK MAINT 191 192 RR 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

* 

USER OPERATOR  NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 2 OPERATOR 
CONSOLE 009 3215 T 
SPOOL G@C 2540 READER * 

SPOOL @@D 2540 PUNCH A 

SPOOL GOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3350 386 005 XASRES MR 
LINK OP1 191 192 RR 


* 


*OP1 IS AN ALTERNATE OPERATOR USERID 
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USER DIRECT (3350) 


* 


USER OP1 NOLOG 3M 32M ABCDEFG 


AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 3 OPERATOR 

IPL CMS 

CONSOLE 009 3215 

SPOOL O@C 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 
MDISK 191 3350 391 G01 XASRES MR 
LINK OPERATOR 191 192 RR 


* 


* This userid is for the IBM CE's use in running 
* OLTSEP. 


* 
* 


OLTSEP is automatically IPLed in the virtual machine. 
A minimum machine size of one megabyte is required to 


* run OLTSEP. 

* The privilege class of F allows the CE to specify 
* intensive recording mode. 

* The console address of O1F is required by OLTSEP. 
* The unit record addresses are those required by 

* OLTSEP. 

* The 5FF minidisk is the CE's OLTSEP pack. 

* 


U 


+ + + 


* 
* 


SER OLTSEP NOLOG 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT OLTSEP IBMCE 

IPL 5FF 

CONSOLE O1F 3215 

SPOOL O0C 2540 READER A 

SPOOL QOD 2540 PUNCH A 

SPOOL OOE 1403 A 

MDISK 5FF 3350 600 555 CEPACK MR 


** EREP ** 


This userid is for the IBM CE's use in running 
CPEREP. 


* CMS is automatically IPLed in the virtual machine. 


* 
* 
* 
* 


* 
* 


U 


The 190 minidisk is the CMS system disk. 

The 191 minidisk may be used to save often-used EREP 
control statements and procedures (EXECs). 

THE 190 MINIDISK HAS THE CMS TXTLIBS NECESSARY TO RUN 
EREP. 7 


SER EREP NOLOG 3M 8M BFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT EREP IBMCE 
IPL CMS 

CONSOLE O1F 3215 

SPOOL OOC 2540 READER A 
SPOOL 80D 2540 PUNCH B 
SPOOL QOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 201 201 RR 
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USER DIRECT (3350) 


MDISK 191 3350 412 002 XASRES WR READ WRITE = MULTIPLE 
* 
USER OPERATNS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 OPERATNS 
IPL CMS 
CONSOLE @69 3215 
SPOOL GC 2540 READER 0 
SPOOL GOD 2540 PUNCH A 
SPOOL O0E 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3350 392 017 XASRES MR RDVF = WDVF = MDVF 


* 
* 


USER IPCS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 8 CE-ROOM 

IPL CMS 
CONSOLE 009 3215 
SPOOL GOC 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL OE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK OPERATNS 193 192 RR 

* 

USER AUTOLOG1 NOLOG 3M 8M ABCDEG 
AUTOLOG OP1 MAINT 
ACCOUNT 9 SYSTEM 

IPL CMS 
CONSOLE 809 3215 
SPOOL O0C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
MDISK 191 3350 409 001 XASRES MR RAUTOLOG WAUTOLOG MAUTOLOG 

* 

USER DISKACNT NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 10 ACCNTNG 

IPL CMS 
CONSOLE 009 3215 
SPOOL OOC 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL QOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3350 410 001 XASRES MR READ WRITE MULTIPLE 

* 

USER IBMPSR NOLOG 3M 8M BG 
ACCOUNT 10 ACCNTNG 

IPL CMS 
CONSOLE 809 3215 
SPOOL O@C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL OOE 1403 A 
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USER DIRECT (3350) 


LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3350 411 @01 XASRES MR 

* 

USER IVPM2 NOLOG 3M 4MG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACTS IVPM2 
CONSOLE 009 3215 
SPOOL @OC 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 194 194 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER VMUTIL NOLOG 3M 8M BDEG 
AUTOLOG AUTOLOG] OP1 MAINT 
ACCOUNT 11 SYSTEM 

IPL CMS 

CONSOLE 009 3215 

SPOOL O@C 2540 READER * 
SPOOL G@D 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER SYSDUMP1 NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 12 SYSTEM 

IPL CMS 
CONSOLE 009 3215 
SPOOL GOC 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 123 3350 000 555 XASRES RR 

MDISK 124 3350 080 555 XAPOO1 RR 
MDISK 125 3350 000 555 XASERV RR 
MDISK 126 3350 000 555 XAPOO2 RR 


* 
* 


USER RSCS NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 13 SYSTEM 

OPTION ACCT SVMSTAT LANG UCENG 
IUCV ANY 

NOPDATA 

* INCLUDE IF GCS NAMED SAVED SYSTEM IS RESTRICTED 
*NAMESAVE GCS 

IPL GCS PARM AUTOLOG 

CONSOLE O1F 3215 T OPERATOR 
SPOOL GOC 2540 READER A 

SPOOL GOD 2540 PUNCH A 

SPOOL OOE 1403 E 

LINK MAINT 595 595 RR 
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USER DIRECT (3350) 


LINK MAINT 59F 191 RR 

LINK MAINT 190 190 RR 

LINK MAINT 193 193 RR 

LINK MAINT 19E 19E RR 

* Assigns real devices or communication lines at the specified 
* addresses to this virtual machine. 

*DEDICATE 740 740 

* 


USER PVM NOLOG 3M 8M BG 
AUTOLOG AUTOLOG] OP1 MAINT 
ACCOUNT 14 SYSTEM 

IPL CMS 

CONSOLE 609 3215 

SPOOL GOC 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK MAINT 36E 191 MR 


* 
IKK AHI RII IIIT AIA IA ARIS IAAI AREAS IIIA IASI IAAI IAI ASAI I I 
if OTHER OPERATING SYSTEM USERIDS = 
HHMI I IIIA IAAI III AI A IAAI AIA IASI IIA II AAI IISA IANS IN AIAIA AKI 
* 
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Sample XAMAINT Directory Entry for a 3350 


If you are using the procedure in Chapter 4, “Installing VM/XA System Product Release 2.1 Using an | 
Existing VM/SP or VM/SP HPO System” on page 215 to install your system, add the following entry to your 
directory: 


736 


te , 


USER XAMAINT NOLOG 16M 16M ABCDEFG 


OPTION ECMODE DIAG98 
ACCOUNT 1 SYSPROG 

IPL 190 
*NAMESAVE GCS 
*NAMESAVE VTAM 
*NAMESAVE HELP 
*NAMESAVE INSTHELP 

CONSOLE 609 3215 T 

SPOOL O0C 2540 READER * 

SPOOL OGD 2540 PUNCH A 

SPOOL OQE 1403 A 

MDISK 123 3350 000 555 XASRES 
MDISK 124 3350 000 555 XAPOQ01 
MDISK 125 3350 OC0 555 XASERV 
MDISK 126 3350 OGO 555 XAPOO2 


MDISK 191 3350 326 039 XASRES 
MDISK 193 3350 414 060 XASRES 
MDISK 194 3350 001 065 XASERV 
MDISK 201 3350 066 028 XASERV 


MDISK 292 3350 094 025 XASERV 
MDISK 392 3350 119 025 XASERV 
MDISK 492 3350 157 013 XASERV 
MDISK 692 3350 144 013 XASERV 
MDISK 593 3350 170 113 XASERV 
MDISK 594 3350 406 075 XAPOQ02 


MDISK 295 3350 474 018 XASRES 
MDISK 395 3350 512 013 XASRES 
MDISK 495 3350 357 007 XASERV 
MDISK 592 3350 344 013 XASERV 
MDISK 892 3350 364 007 XASERV 
MDISK 491 3350 334 010 XASERV 
MDISK 293 3350 371 175 XASERV 
MDISK 294 3350 164 150 XAPOO1 
MDISK 393 3350 326 080 XAPQ02 
MDISK 394 3350 001 163 XAPOO1 
MDISK 19C 3350 256 050 XASRES 
MDISK 49C 3350 481 050 XAPCO2 


MDISK 190 3350 123 074 XASRES 
MDISK 791 3350 197 015 XASRES 
MDISK 89E 3350 102 013 XASRES 
MDISK 5E5 3350 115 007 XASRES 
MDISK 896 3350 227 013 XASRES 
MDISK 895 3350 240 013 XASRES 
MDISK 19E 3350 314 055 XAPO01 
MDISK 19D 3350 284 050 XASERV 


MDISK 291 3350 369 019 XAPGO1 
MDISK 391 3350 388 019 XAPGO1 
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MW 

MW RMAINT WMAINT 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW RCMSAUX WCMSAUX MCMSAUX 
MW RCPAUX WCPAUX MCPAUX 


MW ALL 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW ALL 
MW ALL 


MW 
MW 


MMAINT 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


MDISK 591 3350 601 119 XAPOOZ 
MDISK 691 3350 120 138 XAP002 
MDISK 49D 3350 500 050 XAPO01 
MDISK 501 3350 481 003 XAPOO1 
MDISK 595 3350 484 016 XAPQ01 
* 

MDISK 490 3350 407 074 XAPOO1 
MDISK 423 3350 272 013 XAPOOZ 
MDISK 596 3350 285 025 XAP002 
MDISK 59E 3350 310 013 XAPO002 
* 


XAMAINT Directory Entry (3350) 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 


MDISK 36£ 3350 323 003 XAPOO2 
LINK RSCS 191 499 MW 
LINK MAINT 190 390 RR 


RR RPVM WPVM MPVM 
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XASRES Volume Allocation (3350) 


System Residence DASD Allocation for a 3350 


Figure 54 shows the allocation for the system residence device for the 3350 VM/XA SP Starter System. 


CYL CYL 

6000-08000 
6001-0602 
6903-0016 
6017-6041 


0042-0101 
0102-0305 
0306-0325 
0326-0554 


Figure 54. System Residence DASD Allocation for a 3350 
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Minidisk Maps for a 3350 System Residence Device 


Minidisk Maps (33590) 


Figure 55 shows the minidisk maps for the system residence device for the 3350. To map your own system 
residence device for comparison, issue DISKMAP fn DIRECT, where fn is the name of your directory. 


VOLUME 
CEPACK 


USERID 
OLTSEP 


cUU 
SFF 


DEVTYPE 


3350 


START 
0000 


VOLUME 
XAPO01 


$ALLOC$ 


124 


DEVTYPE 


3350 


START 


0555 
0555 


**OVERLAP** 
**OVERLAP** 


VOLUME 
XAPGO2 


$ALLOCS 


MAINT 
SYSDUMP1 
GCS 
MAINT 
MAINT 
LGLOPR 
CMSBATCH 
MAINT 
$T~DISK$ 
MAINT 


CUU 
DO1 
591 
691 


423 
596 
59E 
36E 
393 
594 
49C 
126 
126 
191 
896 
895 
191 
195 
19C 
BO1 
191 


DEVTYPE 


3350 
3350 
3350 


3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 


START 
9060 


0020 
0039 
21 


GAP 


**QVERLAP** 
**QVERLAP** 


GAP 


Figure 55 (Part 1 of 2). Minidisk Maps of the System Residence Device for a 3350 
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Minidisk Maps (3350) 


OPERATOR 
OP1 
OPERATNS 
AUTOLOG1 
DISKACNT 
IBMPSR 
EREP 
MAINT 
MAINT 


MAINT 
MAINT 
SYSDUMP1 


GAP 


**QVERLAP** 
**QVERLAP** 


VOLUME 
XASERV 


CUU 
B01 
194 
201 
292 
392 
692 
492 
593 


19D 
491 


DEVTYPE 


3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 


3350 
3350 
3350 
3350 


START 
6006 
6001 
0066 
6094 
9119 


0555 


GAP 


**OVERLAP** 
**QVERLAP** 


VOLUME 
XASRES 


USERID 
$ALLOC$ 
$DIRECT$ 
$CP-NUC$ 
$SYSCKP$ 
$SYSWRM$ 
$PAGE$ 
$SPOOL$ 
MAINT 
MAINT 


MAINT 
MAINT 


AQ7 
A03 
BOQ1 
89E 
5E5 


190 
791 


DEVTYPE 


3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 


3350 
3350 


START 
0000 
0001 
0003 
0013 
0015 
0017 
6042 
0102 
0115 

122 
0123 
Q197 

212 


GAP 


GAP 


Figure 55 (Part 2 of 2). Minidisk Maps of the System Residence Device for a 3350 
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Sample Files for a 3375 Starter System 


IBM provides the following sample files with the VM/XA System Product 3375 starter system: 


HCPSYS ASSEMBLE for starter system 
System directory 

System residence DASD allocation 

Minidisk maps of the system residence device. 


Sample HCPSYS ASSEMBLE for a 3375 


This is only a sample file. You need to tailor it to your installation before it can be used. 


SYS TITLE 'HCPSYS75 - HCPSYS FOR VM/XA INSTALL BUILD' 


RHEKRKKEEREKEREEEEEREREEEREEEREEREREREEEEEEEKRKERERERKREEREEEREEEE 


aiid Virtual Machine / System Product 5664-308 *** 
sli Copyright (c) IBM Corporation 1988, 1989 *** 
i Licensed Materials - Property of I BM a! 


— Refer to Copyright Instructions: Form 6120-2083 Ane 


HRHKKRAKKERKEREREREEREEREREEEEEREEEEERERREREEREKEEEEEERKEREKEEREAKE 
REKKREKEKEEKKEEEEKREREREEREEREEEEEEEEKERERREEEEEEEREEEEREREKEREREK 


MODULE NAME - HCPSYS 


DESCRIPTIVE NAME - DEFINITION OF SYSTEM 
FUNCTION - TO DEFINE THE SYSTEM 


REGISTER CONVENTIONS - SYMBOLIC REFERENCES TO REGISTERS ARE 
OF THE FORM "RX" WHERE X IS A NUMBER 


PATCH LABEL - NONE 
MODULE TYPE - DATA 
PROCESSOR - ASSEMBLER H (VERSION 2) 
ATTRIBUTES - RESIDENT, DATA-ONLY 
MACROS - 


SYSSTORE. - DEFINE SYSTEM REAL STORAGE 

- SYSRES - DEFINE SYSTEM RESIDENCE VOLUME 
SYSCPVOL - DEFINE SYSTEM VOLUMES 
SYSOPR - DEFINE SYSTEM OPERATOR 
SYSTIME - DEFINE THE TIME ZONE 
SYSACNT - DEFINE ACCOUNTING USERID 
SYSDUMP - DEFINE DUMP RECEIVER USERID 
SYSEREP - DEFINE EREP RECEIVER USERID 
SYSID - DEFINE SYSTEM ID'S BY PROCESSOR 
SYSUVOL - DEFINE USER VOLUMES TO BE MOUNTED 


SYSEND - END SYSTEM GENERATION 


+ + + £ + e & £ F + ee HH HE FE HF FF HF HH HF HF F HF HF HF F HF F F SF FF FF HF HF HF F 
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HCPSYS ASSEMBLE (3375) 


RANGING FROM © TO 15 (SEE HCPEQUAT COPY) 


SYSFCN - DEFINE PRIV CLASSES ASSIGNED TO CP FUNCTIONS 


HCPSYS ASSEMBLE (3375) 


* GENERAL COMMENTS - THIS MODULE IS THE USER'S RESPONSIBILITY. 
* 


HHEKKEKEKAEEREKEREREEEKEEEREEREREREEEREREREEREEREREEREEREERREREREERREREREERERE 


SPACE 1 


* THE SYSTEM DEFINITION MACROS SYSSTORE, SYSRES, SYSCPVOL, 


* 


* SYSOPR, AND SYSTIME, ARE CODED HERE, IN ANY ORDER 


SPACE 1 
SYSSTORE RMSIZE=32M, VRSIZE=8M, VRFREE=256 
SYSRES SYSVOL=XASRES, 
SYSRES=123, SYSTYPE=3375, 
SYSNUC=005, 
SYSCKP=(021,4) , 
SYSWRM=(025,4) 
SYSTIME ZONE=5,LOC=WEST, ID=EST 
SYSOPR SYSOPER=OPERATOR 
SYSCPVOL XASRES , XASERV , XAPOO1, 


DRUMO1 , DRUMO2 , DRUMO3 , DRUMO4 , DRUMO5 , DRUMO6 , DRUMO7 , 
PAGOO1 , PAGOO2 , PAGGO3 , PAGO04 , PAGOO5 , PAGOG6,, PAGGQ7 , 


SPLOO1 , SPLOO2 , SPLOO3 , SPLOO4 , SPLOO5 , SPLO06, SPLOO7 
SPACE 1 


* ANY OF THE OPTIONAL MACROS THAT ARE DESIRED ARE CODED HERE, 
* IN ANY ORDER 


762 


SPACE 1 

SYSID DEFAULT=INSTTST , (3081A, 3081, 10000) 
SYSACNT USERID=DISKACNT 

SYSDUMP USERID=OPERATNS 

SYSEREP USERID=EREP 


+ ££ & 


SYSUVOL USRPO1, USRPO2 , USRPO3 , USRPO4 , USRPO5, USRPO6 , USRPO7 , * 


USRPO8, USRPO9 
SYSFCN OPER=A,CPRD=CE,CPWT=C,SERV=F ,DFLT=G 
SPACE 1 | 


SPACE 1 
SYSEND 


Installation and Service 


— re 


USER DIRECT (3375) 


Sample Directory for a 3375 


This is only a sample file. You need to tailor it to your installation before it can be used. 
HERRERA KEEEREKREEKEREEEEREREEREEKERERERKREREREKKEKE KKK 


* COPYRIGHT - 5664-308 - (c) COPYRIGHT IBM CORP.- 1988, 1989 * 
ig LICENSED MATERIAL - PROGRAM PROPERTY OF IBM - 
* SEE COPYRIGHT INSTRUCTIONS, G120-2083 is 


REKRKKKKKKEREKEREEERRERKREKEEKEEEREREREEREERREREREEKRKRKKKKRKRKE 
RIKKKKREAREEEREETERERKEEEEERERERREREEEEERREEKEERRRERKEREERKKERKREK 


3375 SYSTEM VM/XA SYSTEM PRODUCT DIRECTORY 

THE ADDRESSES 123, 124, AND 125 ARE VIRTUAL ADDRESSES. 

THE ADDRESS 123 IS CRITICAL SINCE IT IS USED IN HCPSYS AND 
THE DIRECTORY. IF YOU WANT TO CHANGE IT, REMEMBER IT MUST 
BE CHANGED IN HCPSYS, THE ‘DIRECTORY’ STATEMENT BELOW, 

AND IN THE 'MDISK' STATEMENTS FOR THE USERID ‘MAINT’. 
NOTE: REMEMBER THESE ARE ONLY VIRTUAL ADDRESSES NOT REAL 
ADDRESSES, SO THERE IS NO NEED TO CHANGE THEM TO MATCH 
YOUR HARDWARE ADDRESSES. 


THIS DIRECTORY MUST BE MODIFIED IF MDISK PASSWORDS ARE TO 
BE SPECIFIED. WITHOUT MDISK PASSWORDS, MDISKS CANNOT BE 
SHARED USING THE 'CP LINK' COMMAND. A SAMPLE USER ENTRY 
FOLLOWS: (NOTE ONLY THE MDISK STATEMENT) 


USER ANYONE SOMEPASS 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 227727 
IPL 190 
CONSOLE O1F 3215 
SPOOL OOC 2540 READER A 
SPOOL QOD 2540 PUNCH A 
SPOOL QOE 1403 A 
*ace=> MDISK 999 33XX XXX YYY ZZZZZZ MR RPASS WPASS MPASS 


+ + *£© £ ££ Fe & *F SF SF Fe FF HF SF HF HF FF HE HF HF 


WHERE: RPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
READ ONLY MODE. 
WPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
WRITE MODE. 
MPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
MULTI-WRITE MODE. 


NOTE: EACH PASSWORD MAY BE 1-8 CHARACTERS IN LENGTH. 


+ £ +£ ¢ € F£ £€ € FF SF FF HF HF HF F FF HF SF FE HF HF He HH FE FF HF HF HF FF HF FE HF OF HR F 


+ £¢ +€+ £© &£ + £ * HF HF F 


HHA AHH AIA RERERRKEREEEREEKREKRREREEEEEEERERKEEEERREEEEEERKEEE 


Following is a sample user entry and a brief description 
of each entry. A more detailed description may be found 
by referencing the VM/XA System Product Planning and 
Administration manual. 


USER CMS1 abcl123 3M 32M G 
- Userid is CMS1 
- Logon password is abcl23 
- At logon time, virtual storage will equal 3M 
- Maximum storage that may be defined equals 32M 
- Privilege class is G 


+ £¢ £ + &€ ££ F FF F&F FF F HF 
+ + + + & © SF F SF & FF F HE FF 


AUTOLOG AUTOLOG1 OP1 MAINT 
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—a oe eee ieee 
Ce ti rr en i ene 


USER DIRECT (3375) 


- Allows user CMS1 to be autolog'd by AUTOLOG], 
OP1, and MAINT 


ACCOUNT ACT4 CMSTST 
- Time used by CMS1 will be charged to account ACT4 
- Printed output will be sent to distribution CMSTST 


IPL CMS 
- Will cause automatic IPL of named save system of 
CMS 


CONSOLE 009 3215 
- Defines virtual machines console as a 3215 at a 
virtual address of 009 


SPOOL GOC 2540 READER A 
SPOOL QOD 2540 PUNCH A 
SPOOL GOE 1403 A 
- Defines virtual unit record devices of reader, 
punch, and printer with a spooling class of '‘A' 


LINK MAINT 190 190 RR 
- Allows read access to minidisk 190 of user 'MAINT'‘ 


LINK MAINT 19E 19E RR 
- Allows read access to minidisk 19E of user 'MAINT' 


LINK MAINT 19D 19D RR 
- Allows read access to minidisk 19d of user 'MAINT' 


MDISK 999 3350 236 022 CPPACK WR RPASS WPASS 

- Defines minidisk with a virtual address of 999 

- Specifies that the minidisk resides on a real 3350 

- Minidisk starts at cylinder 236 

- Mdisk is 22 cylinders in size (starting at cyl 236 

- The real volume serial number is 'CPPACK' 

- Mdisk is to be accessed in write mode if no other 
user has write access. Alternate access read-only 

- RPASS is the required password for another user to 
link to this minidisk in read mode 

- WPASS is the required password for another user to 


link to this minidisk in write mode 
KRKERKKREKERREKKEREKERERKAEEKEKCHEEREKEKKEEKKEEEEKKEKRKKKKEKKKKEK 


* 
* 
* 


DIRECTORY 123 3375 XASRES 


* 


+ +  F SF FE He HF EH EF FH SF FH HF F SF HF HF HF HF HF F HF HF FE SF HF HF HF FE HF SF FE FH FF FH FE HF F F 
+ £¢ + ee He FE FF HF SF HF SF FF SF FF HF SF F SF HH FF HF HF FF HF HF HF F HF HF FF HF F HF F HF HF 


KEKEKKEREEKEEKERKKERREEREEREKEREREREEREREEKEKEEREREERERERERKEREES 
* SYSTEM RESERVED AREAS NOT FOR MINIDISKS * 
RREEREREKKEKERERRERAEREREKEEREKREREREREKREREEREREEREKREREEEERERERKE 
* 


USER $ALLOC$ NOLOG 

MDISK AO1 3375 O60 GO1 XASRES R 
MDISK BO1 3375 000 601 XASERV R> 
MDISK CO1 3375 000 001 XAPOO1 R 


* 


USER $DIRECT$ NOLOG 
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USER DIRECT (3375) 


MDISK AO4 3375 001 004 XASRES R 
* 

USER $CP-NUC$ NOLOG 

MDISK AO9 3375 G05 016 XASRES R 
* 

USER $SYSCKP$ NOLOG 

MDISK AQ6 3375 021 004 XASRES R 
* 


USER $SYSWRM$ NOLOG 

MDISK AQ7 3375 025 004 XASRES R 
* 

USER $PAGE$ NOLOG 

MDISK AQ3 3375 029 038 XASRES R 
* 

USER $SPOOL$ NOLOG 

MDISK BO1l 3375 067 092 XASRES R 
* 


USER $T-DISK$ NOLOG 
MDISK BQ1 3375 561 031 XASRES R 


* 
HII AHI IAN IIIS ISIS IAI AIAN ASAI IS IAI ASAI ANSARI IAAI 
* CMS USERIDS ie 
HAKKAR IIIA IR IRIAIIIAI III ISI ASAI IIASA SISASAIIAIASIAINAARASAASEAI 
tk 


USER CMS1 NOLOG 3M 32M G 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT4 CMSTST 

IPL CMS 

CONSOLE 009 3215 

SPOOL OO0C 2540 READER A 
SPOOL OGD 2540 PUNCH A 
SPOOL QOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 


* 
HAKKAR KK KEKE ERE EEREEREEREREEREREEERREEREEREEKERERES 
* PROP LOGICAL OPERATOR * 
Soke Hehe de Fee Teh te he ke HK EKEKEREREEREEREREREREEEEEEKEEEREEKRE 
* 


USER LGLOPR NOLOG 512K 16M ABCDEG 
ACCOUNT ACT1 PROP 

IPL CMS 

CONSOLE 009 3215 

SPOOL GOC 2540 READER A 

SPOOL GOD 2540 PUNCH A 

SPOOL OOE 1403 A 

MDISK 191 3375 487 GO1 XASRES WR 
LINK MAINT 194 194 RR 

LINK MAINT 190 190 RR 

LINK OPERATOR 191 291 RR 


* 
KKK EKEKEERREEEEEKEEREEREERKREREEERREREERRREERE 
* SYSTEM RELATED USERIDS * 
RAKE ERRRERAEREEEEEREREREREKEKREEREREREREREEEKREKE 
* 


USER MAINT NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 
IPL 190 
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— se ei ee ee ee ee eee ee er ee ce eee ieee 


eee ee 


7166 


USER DIRECT (3375) 


NAMESAVE GCS 

NAMESAVE VTAM 

NAMESAVE HELP 

NAMESAVE INSTHELP 

CONSOLE 609 3215 T 

SPOOL G@C 2540 READER * 

SPOOL OGD 2540 PUNCH A 

SPOOL GOE 1403 A 

MDISK 123 3375 000 959 XASRES 
MDISK 124 3375 600 959 XAPO01 
MDISK 125 3375 000 959 XASERV 
* 

MDISK 191 3375 492 047 XASRES 
MDISK 193 3375 742 076 XASRES 
MDISK 194 3375 818 082 XASRES 
MDISK 201 3375 064 035 XASERV 
* 

MDISK 292 3375 099 031 XASERV 
MDISK 392 3375 130 031 XASERV 
MDISK 492 3375 161 016 XASERV 
MDISK 692 3375 177 016 XASERV 
MDISK 594 3375 193 118 XASERV 
MDISK 593 3375 327 141 XASERV 
MDISK 423 3375 311 016 XASERV 
* 

MDISK 295 3375 676 020 XASRES 
MDISK 395 3375 447 016 XASRES 
MDISK 495 3375 468 008 XASERV 
MDISK 592 3375 476 016 XASERV 
MDISK 892 3375 492 608 XASERV 
MDISK 491 3375 500 013 XASERV 
MDISK 791 3375 513 019 XASERV 
MDISK 89E 3375 592 016 XASRES 
MDISK 5E5 3375 423 005 XASRES 
MDISK 896 3375 608 016 XASRES 
MDISK 895 3375 624 016 XASRES 


MDISK 293 3375 532 220 XASERV 
MDISK 294 3375 752 188 XASERV 
MDISK 393 3375 001 098 XAPCO01 
MDISK 394 3375 743 204 XAPOO1 
MDISK 19C 3375 103 063 XAPOO01 
MDISK 49C 3375 166 063 XAPOO1 
MDISK 596.3375 183 032 XASRES 
MDISK 59E 3375 463 016 XASRES 
* 

MDISK 190 3375 223 113 XASRES 
MDISK 19E 3375 235 069 XAPGO1 
MDISK 19D 3375 001 063 XASERV 
* 

MDISK 291 3375 336 024 XASRES 
MDISK 391 3375 159 024 XASRES 
MDISK 591 3375 304 149 XAPOO1 
MDISK 691 3375 453 173 XAPGO1 
MDISK 49D 3375 360 063 XASRES 
MDISK 490 3375 626 113 XAPO01 
MDISK 501 3375 739 004 XAPGO1 
MDISK 595 3375 640 020 XASRES 


* 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
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MW RMAINT WMAINT 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW RCMSAUX WCMSAUX MCMSAUX 
MCPAUX 


MW RCPAUX WCPAUX 


MW 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MMAINT 


MDISK 36E 3375 099 604 XAPOO1 RR RPVM WPYM 
LINK RSCS 191 499 MW 
* 
USER CMSBATCH NOLOG 1M 2M G 

ACCOUNT 3 SYSTEM 

OPTION ACCT 

IPL CMS PARM AUTOCR 

CONSOLE 609 3215 

SPOOL @@C 2540 READER * 

SPOOL GOD 2540 PUNCH A 

SPOOL GOE 1403 A 

LINK MAINT 199 190 RR 

MDISK 195 3375 488 004 XASRES MR RBATCH WBATCH 
¥ 
USER GCS NOLOG 16M 16M ABCDEFG 

AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT GCS RECVM 

IPL GCS 

NAMESAVE GCS 

CONSOLE 909 3215 

SPOOL @OC 2540 READER * 

SPOOL QOD 2540 PUNCH A 

SPOOL QOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19D 19D RR 

LINK MAINT 595 595 

LINK MAINT 59E 59E 

MDISK 191 3375 441 G06 XASRES MR RGCS WGCS MGCS 


* 


USER SYSMAINT NOLOG 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 
IPL CMS 
CONSOLE 089 3215 T 
SPOOL GOC 2540 READER * 

SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 123 123 MW 
LINK MAINT 191 192 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

x | 

USER OPERATOR NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 2 OPERATOR 
CONSOLE 009 3215 T 
SPOOL @OC 2540 READER * 

SPOOL OOD 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3375 696 008 XASRES MR 
LINK OP1 191 192 RR 


* 


*OP1 IS AN ALTERNATE OPERATOR USERID 
* 


USER OP1 NOLOG 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 


MPVM 


MBATCH 


USER DIRECT (3375) 
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USER DIRECT (3375) 


ACCOUNT 3 OPERATOR 

IPL CMS 

CONSOLE 009 3215 

SPOOL GOC 2540 READER * 

SPOOL GOD 2540 PUNCH A 

SPOOL QOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3375 704 902 XASRES MR 

LINK OPERATOR 191 192 RR 
* 
* This userid is for the IBM CE's use in running 
* OLTSEP. 
* OLTSEP is automatically IPLed in the virtual machine. 
* A minimum machine size of one megabyte is required to 
* run OLTSEP. 
* The privilege class of F allows the CE to specify 
* intensive recording mode. 
* The console address of 01F is required by OLTSEP. 
* The unit record addresses are those required by 


* OLTSEP. 
* The 5FF minidisk is the CE's OLTSEP pack. 
* 


USER OLTSEP NOLOG 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT OLTSEP IBMCE 
IPL 5FF 
CONSOLE O1F 3215 
SPOOL O0C 2540 READER A 
SPOOL OGD 2540 PUNCH A 
SPOOL QOE 1403 A 
MDISK 5FF 3375 600 959 CEPACK MR 


+ + 


** EREP *# 


* This userid is for the IBM CE's use in running 
* CPEREP. 


* CMS is automatically IPLed in the virtual machine. 


* The 190 minidisk is the CMS system disk. 


* The 191 minidisk may be used to save often-used EREP 


* control statements and procedures (EXECs). 


* THE 190 MINIDISK HAS THE CMS TXTLIBS NECESSARY TO RUN 


* EREP, 
* 


USER EREP NOLOG 3M 8M BFG 
AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT EREP IBMCE 

IPL CMS 

CONSOLE O1F 3215 

SPOOL O0C 2540 READER A 

SPOOL 00D 2540 PUNCH B 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 201 201 RR 

MDISK 191 3375 738 004 XASRES WR READ WRITE 
* 
USER OPERATNS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 OPERATNS 
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MULTIPLE 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


IPL CMS 

CONSOLE 609 3215 

SPOOL @@C 2540 READER D 
SPOOL 00D 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 


MDISK 191 3375 706 026 XASRES MR RDVF WDVF MDVF 


* 
* 


USER IPCS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 8 CE-ROOM 

IPL CMS 
CONSOLE 609 3215 
SPOOL GOC 2540 READER * 
SPOOL GD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK OPERATNS 193 192 RR 

* 

USER AUTOLOG1 NOLCG 3M 8M ABCDEG 
AUTOLOG OP1 MAINT 
ACCOUNT 9 SYSTEM 

IPL CMS 
CONSOLE 669 3215 
SPOOL OOC 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 


MDISK 191 3375 732 002 XASRES MR RAUTOLOG WAUTOLOG MAUTOLOG 


* 


USER DISKACNT NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 10 ACCNTNG 

IPL CMS 
CONSOLE 069 3215 
SPOOL 6OC 2540 READER * 
SPOOL QOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3375 734 002 XASRES MR READ WRITE MULTIPLE 

* 

USER IBMPSR NOLOG 3M 8M BG 
ACCOUNT 10 ACCNTNG 

IPL CMS 

CONSOLE 069 3215 

SPOOL GOC 2540 READER * 
SPOOL 00D 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 


USER DIRECT (3375) 


Appendix C. VM/XA System Product Starter System Information 769 


USER DIRECT (3375) 


MDISK 191 3375 736 602 XASRES WR 

* 

USER IVPM2 NOLOG 3M 4M G 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACTS IVPM2 
CONSOLE 609 3215 
SPOOL OGC 2540 READER A 
SPOOL GOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 194 194 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER VMUTIL NOLOG 3M 8M BDEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 11 SYSTEM 

IPL CMS 

CONSOLE 909 3215 

SPOOL GOC 2540 READER * 
SPOOL QOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER SYSDUMP1 NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 12 SYSTEM 

IPL CMS 
CONSOLE 609 3215 
SPOOL OCC 2540 READER * 
SPOOL O6D 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 123 3375 O00 959 XASRES RR 
MDISK 124 3375 060 959 XAPGO1 RR 
MDISK 125 3375 060 959 XASERV RR 


* 
* 


USER RSCS NOLOG 3M 8M BG 
AUTOLGG AUTOLOG1 OP1 MAINT 
ACCOUNT 13 SYSTEM 

OPTION ACCT SVMSTAT LANG UCENG 
IUCV ANY 

NOPDATA 

* INCLUDE IF GCS NAMED SAVED SYSTEM IS RESTRICTED 
*NAMESAVE GCS 

IPL GCS PARM AUTOLOG 

CONSOLE 01F 3215 T OPERATOR 
SPOOL GOC 2540 READER A 

SPOOL GOD 2540 PUNCH A 

SPOOL GOE 1403 E 

LINK MAINT 595 595 RR 

LINK MAINT 59F 191 RR 

LINK MAINT 190 190 RR 

LINK MAINT 193 193 RR 

LINK MAINT 19E 19E RR 
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USER DIRECT (3375) 


* Assigns real devices or communication lines at the specified 
* addresses to this virtual machine. 
*DEDICATE 740 740 

: | 

USER PVM NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 14 SYSTEM 

IPL CMS 

CONSOLE 009 3215 

SPOOL GOC 2540 READER * 

SPOOL GOD 2540 PUNCH A 

SPOOL GOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

LINK MAINT 36E 191 MR 


* 
* 
KREKKEKKEKREKEEKREREKEEEEEKEKEKKRERREREEERREERREERERERREREEKRRRERER 
* OTHER OPERATING SYSTEM USERIDS * 
HKKEKEKREREAEEKEREREEKERKERREEEREREEEEEERREREREERERRRREREEREREEEEE 
* 
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XAMAINT Directory Entry (3375) 


Sample XAMAINT Directory Entry for a 3375 


If you are using the procedure in Chapter 4, “Installing VM/XA System Product Release 2.1 Using an 
Existing VM/SP or VM/SP HPO System” on page 215 to install your system, add the following entry to your 
directory: | 

* 


USER XAMAINT NOLOG 16M 16M ABCDEFG 
OPTION ECMODE DIAG98 

ACCOUNT 1 SYSPROG 

IPL 190 

*NAMESAVE GCS 

*NAMESAVE VTAM 

*NAMESAVE HELP 

*NAMESAVE INSTHELP 


— ee ee ee ec ec we ee ee eee ee ee eee eee eee eee eee 


— —— ee wees eee oc ee ee 
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CONSOLE 909 3215 T 

SPOOL OGC 2540 READER * 
SPOOL OGD 2540 PUNCH A 
SPOOL GOE 1403 A 

MDISK 123 3375 000 959 XASRES 
MDISK 124 3375 000 959 XAPO01 
MDISK 125 3375 660 959 XASERV 


* 


MDISK 191 3375 492 047 XASRES 
MDISK 193 3375 742 076 XASRES 
MDISK 194 3375 818 082 XASRES 
MDISK 201 3375 064 035 XASERV 


* 


MDISK 292 3375 099 031 XASERV 
MDISK 392 3375 130 031 XASERV 
MDISK 492 3375 161 016 XASERV 
MDISK 692 3375 177 016 XASERV 
MDISK 594 3375 193 118 XASERV 
MDISK 593 3375 327 141 XASERV 
MDISK 423 3375 311 016 XASERV 


* 


MDISK 295 3375 676 020 XASRES 
MDISK 395 3375 447 016 XASRES 
MDISK 495 3375 468 608 XASERV 
MDISK 592 3375 476 016 XASERV 
MDISK 892 3375 492 008 XASERV 
MDISK 491 3375 500 013 XASERV 
MDISK 791 3375 513 019 XASERV 
MDISK 89E 3375 592 016 XASRES 
MDISK 5E5 3375 423 005 XASRES 
MDISK 896 3375 608 016 XASRES 
MDISK 895 3375 624 016 XASRES 


MDISK 293 3375 532 220 XASERV 
MDISK 294 3375 752 188 XASERV 
MDISK 393 3375 601 098 XAP0Q01 
MDISK 394 3375 743 204 XAPO01 
MDISK 19C 3375 103 063 XAPO01 
MDISK 49C 3375 166 063 XAPOO1 
MDISK 596 3375 183 032 XASRES 
MDISK 59E 3375 463 016 XAPO01 


MDISK 190 3375 223 113 XASRES 
MDISK 19E 3375 235 069 XAPGO1 


Installation and Service 


MW RMAINT WMAINT MMAINT 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW RCMSAUX WCMSAUX MCMSAUX 
MW RCPAUX WCPAUX MCPAUX 
WR 


MDISK 19D 3375 001 063 XASERV 
* 


MDISK 291 3375 336 024 XASRES 
MDISK 391 3375 159 024 XASRES 
MDISK 591 3375 304 149 XAPQ01 
MDISK 691 3375 453 173 XAPCQ1 
MDISK 49D 3375 360 063 -XASRES 
MDISK 499 3375 626 113 XAPGO1 
MDISK 501 3375 739 004 XAPGO1 
MDISK 595 3375 640 020 XASRES 


* 


XAMAINT Directory Entry (3375) 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36E 3375 099 004 XAPOO1 RR RPVM WPVM MPVM 


LINK RSCS 191 499 MW 
LINK MAINT 190 390 RR 
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XASRES Volume Allocation (3375) 


System Residence DASD Allocation for a 3375 


Figure 56 shows the allocation for the system residence device for the 3375 VM/XA SP starter system. 


CYL CYL 

0000-000 
6001-0004 
0005-0028 


0029-0066 
0067-0158 
0159-0560 
0561-0591 
0592-0958 


Figure 56. System Residence DASD Allocation for a 3375 
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Minidisk Maps (3375) 


Minidisk Maps for a 3375 System Residence Device 


Figure 57 shows the minidisk maps of the system residence device for the 3375. To map your own system 
residence device for comparison, issue DISKMAP /n DIRECT, where jn is the name of your directory. 


| } VOLUME USERID CUU DEVTYPE START END SIZE 
| | CEPACK OLTSEP 5FF 3375 0000 0958 0959 


| | VOLUME USERID CUU DEVTYPE START END SIZE 

| | XAP@01  $ALLOC$ CO1 3375 0060 0000 0001 

| MAINT 393 3375 6001 0098 6098 

| MAINT 36E 3375 6099 0102 0004 

| MAINT 19C 3375 0103 0165 0063 

| MAINT 49C 3375 0166 0228 0063 

229 234 6 GAP 
| MAINT 19E 3375 0235 0303 0069 

| MAINT 591 3375 0304 0452 9149 

| MAINT 691 3375 0453 0625 0173 

| MAINT 490 3375 0626 0738 0113 

| MAINT 501 3375 Q739 9742 6004 

| MAINT 394 3375 0743 0946 0204 

| MAINT 124 3375 0009 0958 0959 **QVERLAP** 
| 


SYSDUMP1 124 3375 6000 #6958 © 0959 **0VERLAP** 


| | VOLUME USERID CUU = DEVTYPE START END SIZE 
| | XASERV $ALLOC$ BQ1 3375 0000 8800 G601 
| MAINT 19D 3375 0001 0063 0063 
| MAINT 201 3375 6064 8098 6035 
| MAINT 292 3375 0099 0129 0031 
| MAINT 392 3375 0130 0160 G031 
| MAINT 492 3375 0161 0176 0016 
| MAINT 692 3375 0177 0192 0016 
| MAINT 594 3375 0193 0310 0118 
| MAINT 423 3375 0311 0326 0016 
| MAINT 593 3375 0327 0467 0141 
| MAINT 495 3375 0468 0475 0008 
| MAINT 592 3375 0476 0491 6016 
| MAINT 892 3375 0492 0499 0008 
| MAINT 491 3375 0500 0512 6013 
| MAINT 791 3375 0513 0531 0019 
| MAINT 293 3375 0532 0751 0220 
| MAINT 294 3375 Q752 9939 0188 
| MAINT 125 3375 0000 0958 Q959 **QVERLAP** 
| 


_ SYSDUMP1 125 3375 GOGO 0958 0959 **OVERLAP** 


{ Figure 57 (Part 1 of 2). Minidisk Maps of the System Residence Device for a 3375 
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Minidisk Maps (3375) 


VOLUME 
XASRES 


USERID 
$ALLOC$ 
$DIRECT$ 
$CP-NUC$ 
$SYSCKP$ 
$SYSWRMS$ 
$PAGE$ 
$SPOOL$ 
MAINT 
MAINT 


MAINT 
MAINT 
MAINT 
MAINT 


GCS 
MAINT 
MAINT 


LGLOPR 
CMSBATCH 
MAINT 


$T-DISK$ | 


MAINT 
MAINT 
MAINT 
MAINT 


MAINT 
OPERATOR 
OP1 
OPERATNS 
AUTOLOG1 
DISKACNT 


SYSDUMP1 


CUU 
AQ1 
AQ4 
AQ9 
AQ6 
AQ7 
AQ3 
B01 
391 


596 


190 
291 
49D 
5E5 


191 


395 
59E 


191 
195 
191 


BO1 
89E 
896 
895 
595 


295 
191 
191 
191 
191 
191 
191 
191 
193 
194 
123 
123 


DEVTYPE 


3375 
3375 
3375 
3375 
3375 
3375 
3375 
3375 
3375 


3375 
3375 
3375 
3375 


3375 
3375 
3375 


3375 
3375 
3375 


3375 
3375 
3375 
3375 
3375 


3375 
3375 
3375 
3375 
3375 
3375 
3375 
3375 
3375 
3375 
3375 
3375 


START 
6000 
0001 
6005 
0021 
0025 
0029 
0067 
0159 
0183 

215 
0223 
0336 
0360 
0423 


8 GAP 


13 GAP 


8 GAP 


22 GAP 


16 GAP 


0959 **QVERLAP** 
Q959 **QVERLAP** 


Figure 57 (Part 2 of 2). Minidisk Maps of the System Residence Device for a 3375 
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HCPSYS ASSEMBLE (3380) 


Sample Files for a 3380 Starter System 


IBM provides the following sample files with the VM/XA SP 3380 Starter System: 


e HCPSYS ASSEMBLE for Starter System 

e System directories for 3380, 3380-E4, and 3380-K. 
e System residence DASD allocation 

¢ Minidisk maps of the system residence device. 


Sample HCPSYS ASSEMBLE for a 3380 


This is only a sample file. You need to tailor it to your installation before it can be used. 
SYS TITLE 'HCPSYS80 - HCPSYS FOR VM/XA INSTALL BUILD' 


REEKKEKREEREKREKREEREREREREEREREEEREREEREERREEREEREEERRERERKREREEREREREEE 


* 5664-308 (C) COPYRIGHT IBM CORPORATION - 1988,1989 = 
* LICENSED MATERIALS - PROPERTY OF IBM i 
* SEE COPYRIGHT INSTRUCTIONS, 6120-2083 - 


HRAKKKEKRKEEEEEEKRKERERERERERREEREREREEEKKEREEREKREEREERREREEEREKEEREREREREER 
HHREKKEKEEEEERKKERKEKRERKEREREREKEEREEREEEKERREERKEKEEEREEREREEEKREEEEER 
* 


* MODULE NAME - HCPSYS 


* 


* DESCRIPTIVE NAME - DEFINITION OF SYSTEM 


FUNCTION - TO DEFINE THE SYSTEM 


REGISTER CONVENTIONS - SYMBOLIC REFERENCES TO REGISTERS ARE 
OF THE FORM "RX" WHERE X IS A NUMBER 
RANGING FROM © TO 15 (SEE HCPEQUAT COPY) 


PATCH LABEL - NONE 
MODULE TYPE - DATA 
PROCESSOR - ASSEMBLER H (VERSION 2) 
ATTRIBUTES - RESIDENT, DATA-ONLY 
MACROS - 


SYSSTORE - DEFINE SYSTEM REAL STORAGE 

SYSRES - DEFINE SYSTEM RESIDENCE VOLUME 
SYSCPVOL - DEFINE SYSTEM VOLUMES 

SYSOPR - DEFINE SYSTEM OPERATOR 

SYSTIME - DEFINE THE TIME ZONE 

SYSACNT - DEFINE ACCOUNTING USERID 

SYSDUMP - DEFINE DUMP RECEIVER USERID 
SYSEREP - DEFINE EREP RECEIVER USERID 

SYSID - DEFINE SYSTEM ID'S BY PROCESSOR 
SYSUVOL - DEFINE USER VOLUMES TO BE MOUNTED 
SYSFCN - DEFINE PRIV CLASSES ASSIGNED TO CP FUNCTIONS 
SYSEND - END SYSTEM GENERATION 


+ + + € €¢ ¢ + + © + & € + + FF HF F FF $F FHF He HF FE + FOF OF HF FF HF FS HR 


GENERAL COMMENTS - THIS MODULE IS THE USER'S RESPONSIBILITY. 
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HCPSYS ASSEMBLE (3380) 


* 
HREKKKKKEKRERRKEKREREERKEEEEEREREREEEREKREEEKEEERERERKEREREREEREREEEKKERKKKKE 


SPACE 1 
* THE SYSTEM DEFINITION MACROS SYSSTORE, SYSRES, SYSCPVOL, 
* SYSOPR, AND SYSTIME, ARE CODED HERE, IN ANY ORDER 
SPACE 1 
SYSSTORE RMSIZE=32M, VRSIZE=8M, VRFREE=256 
SYSRES SYSVOL=XASRES, 
SYSRES=123 , SYSTYPE=3380, 
SYSNUC=603, 
SYSCKP=(013,2), 
SYSWRM=(015,2) 
SYSTIME ZONE=5,LOC=WEST , ID=EST 
SYSOPR SYSOPER=OPERATOR 
SYSCPVOL XASRES , XASERV , XAPOOQ1, . 
DRUMO1 , DRUMO2 , DRUMO3 , DRUMO4 , DRUMO5 , DRUMO6 , DRUMO?7 , - 
PAGOO1 , PAGOO2 , PAGO03 , PAGOO4 , PAGOO5 , PAGO06,, PAGOO7 , * 
SPLOO1, SPLOOZ , SPLOO3 , SPLOO4 , SPLOO5 , SPLO06 , SPLOO7 
SPACE 1 
* ANY OF THE OPTIONAL MACROS THAT ARE DESIRED ARE CODED HERE, 
* IN ANY ORDER 
SPACE 1 
SYSID DEFAULT=INSTTST, (3081A, 3081, 10600) 
SYSACNT USERID=DISKACNT 
SYSDUMP’ USERID=OPERATNS 
SYSEREP USERID=EREP 
SYSUVOL USRPO1, USRPO2 , USRPO3 , USRPO4 , USRPO5 , USRPO6, USRPO7 , * 
USRPO8 , USRPOS 
SYSFCN OPER=A,CPRD=CE ,CPWT=C,SERV=F ,DFLT=G 
SPACE 1 


t+ + + + 


SPACE 1 
SYSEND 
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USER DIRECT (3380) 


There are three sets of sample directory, minidisk allocations, and minidisk maps for different models of 3380 
DASD. The first set (“Sample Directory for a 3380,” “System Residence DASD Allocation for a 3380” on 
page 790 , and “Minidisk Maps for a 3380 System Residence Device” on page 791) is for the 3380. The 
second set (“Sample Directory for a 3380-E4” on page 793, “System Residence DASD Allocation for a 
3380-E4” on page 804, and “Minidisk Maps for a 3380-E4 System Residence Device” on page 805) is for the 
3380-E4. The third set (“Sample Directory for a 3380-K” on page 807, “System Residence DASD Allocation 
for a 3380-K” on page 818, and “Minidisk Maps for a 3380-K System Residence Device” on page 819) is for 
the 3380-K. 


Sample Directory for a 3380 


This is only a sample file. You need to tailor it to your installation before it can be used. 


RKRERKEKEKEREKCREREREEREREREEREREREREEKEREERERERREREREREREKERERKER 


* COPYRIGHT - 5664-308 - (c) COPYRIGHT IBM CORP.- 1988, 1989 * 
2 LICENSED MATERIAL - PROGRAM PROPERTY OF IBM . 
: SEE COPYRIGHT INSTRUCTIONS, 6120-2083 . 


KREKKKREKERKEKREKEKERERRREREEKREERKREREKEERERERRERERERKREERERRREREREERE 
KEKRKEKEKREREEEKEEKEEEEKEREREEREERREREEREEREEEKEREREREEEREREREREEREER 


+ + + + &€ & + FF F HF HF F&F HF FF HF HF HF HF FHF HF HF F 


*====> 

* 

* WHERE: RPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
* READ ONLY MODE. 

ke 

: WRITE MODE. 

* 

~ MULTI-WRITE MODE. 

* 

* NOTE: EACH PASSWORD MAY BE 1-8 CHARACTERS IN LENGTH. 
* 


3380 SYSTEM VM/XA SYSTEM PRODUCT DIRECTORY 

THE ADDRESSES 123, 124, AND 125 ARE VIRTUAL ADDRESSES. 

THE ADDRESS 123 IS CRITICAL SINCE IT IS USED IN HCPSYS AND 
THE DIRECTORY. IF YOU WANT TO CHANGE IT, REMEMBER IT MUST 
BE CHANGED IN HCPSYS, THE ‘DIRECTORY’ STATEMENT BELOW, 

AND IN THE 'MDISK’ STATEMENTS FOR THE USERID ‘MAINT’. 
NOTE: REMEMBER THESE ARE ONLY VIRTUAL ADDRESSES NOT REAL 
ADDRESSES, SO THERE IS NO NEED TO CHANGE THEM TO MATCH 


YOUR HARDWARE ADDRESSES. 


THIS DIRECTORY MUST BE MODIFIED IF 


BE SPECIFIED. WITHOUT MDISK PASSWORDS, MDISKS CANNOT BE 


SHARED USING THE 'CP LINK' COMMAND. 


FOLLOWS: (NOTE ONLY THE MDISK STATEMENT) 


USER ANYONE SOMEPASS 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 727777 
IPL 190 
CONSOLE O1F 3215 
SPOOL @OC 2540 READER A 
SPOOL OGD 2540 PUNCH A 
SPOOL OOE 1403 A 


WPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 


MPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 


MDISK 999 33XX XXX YYY ZZZZZZ MR RPASS WPASS MPASS 


MDISK PASSWORDS ARE TO 


A SAMPLE USER ENTRY 


+ + + © + £ € + &€+ + + + F&F HH FF FE FF Fe HH F F FH SF HF FE HF FSF HF OF HF HF HF OF 


KERKREKEREKEKERERREREEEEEEREREREKERERKEEREERRERERERREREREREKREREREE 


* 


+ + + & 


Following is a sample user entry and a brief description 
of each entry. A more detailed description may be found 
by referencing the VM/XA System Product Planning and 


* 


+ + + 
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USER DIRECT (3380) 


Administration manual. 


USER CMS1 abc123 3M 32M G 
- Userid is CMS1 
- Logon password is abci23 
- At logon time, virtual storage will equal 3M 
- Maximum storage that may be defined equals 32M 
- Privilege class is G 


AUTOLOG AUTOLOG1 OP1 MAINT 
- Allows user CMS1 to be autolog'd by AUTOLOG1, 
OP1, and MAINT 


ACCOUNT ACT4 CMSTST 
- Time used by CMS1 will be charged to account ACT4 
- Printed output will be sent to distribution CMSTST 


IPL CMS 
- Will cause automatic IPL of named save system of 
CMS 


CONSOLE 669 3215 
- Defines virtual machines console as a 3215 at a 
virtual address of 009 


* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

*x 

* 

* 

* SPOOL @GC 2540 READER A 

- SPOOL GOD 2540 PUNCH A 

~ SPOOL GOE 1403 A 

* - Defines virtual unit record devices of reader, 
* punch, and printer with a spooling class of ‘A' 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
ve 
¥ 
* 
* 
* 


LINK MAINT 190 190 RR 
- Allows read access to minidisk 190 of user 'MAINT' 


LINK MAINT 19E 19E RR 
- Allows read access to minidisk 19E of user ‘MAINT' 


LINK MAINT 19D 19D RR 
- Allows read access to minidisk 19d of user 'MAINT'‘ 


MDISK 999 3350 236 022 CPPACK WR RPASS WPASS 

- Defines minidisk with a virtual address of 999 

- Specifies that the minidisk resides on a real 3350 

- Minidisk starts at cylinder 236 

- Mdisk is 22 cylinders in size (starting at cyl 236 

- The real volume serial number is ‘CPPACK' 

- Mdisk is to be accessed in write mode if no other 
user has write access. Alternate access read-only 

- RPASS is the required password for another user to 
link to this minidisk in read mode 

- WPASS is the required password for another user to 


link to this minidisk in write mode 
HRARKEKEKKREKEREEKE AKER 


* 


¢ ££ + ¢ & &€ 6 + $+ €+ & &F FF HF F&F HF F HF HF HF F HF FF HF HH F HF HF HF HF HF HOF HF FE OF FE OF HF OF HF HF FO HF HF FOF HF FOF HF F 


* 

* 

DIRECTORY 123 3380 XASRES 

* 

HAIR IIIA IIIA ARIA NAS AISA IN ISAS ASSIA IIIS AINA RI III 


" SYSTEM RESERVED AREAS NOT FOR MINIDISKS - 
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USER DIRECT (3380) 


HHKKKKKEKKEREEERREE KEE REE EEREREEKREEERERERKKERERKEE 
* 


USER $ALLOC$ NOLOG 

MDISK AQ1 3380 000 001 XASRES R 
MDISK B01 3380 600 001 XASERV R 
MDISK CO1 3380 000 001 XAPOO1 R 
* 


USER $DIRECT$ NOLOG 
MDISK A04 3380 001 002 XASRES R 
* 


USER $CP-NUC$ NOLOG 

MDISK AQ9 3380 003 010 XASRES R 
*® 

USER $SYSCKP$ NOLOG 

MDISK AQ6 3380 013 Q02 XASRES R 
* 

USER $SYSWRM$ NOLOG 

MDISK AQ7 3380 015 O02 XASRES R 
* 

USER $PAGE$ NOLOG 

MDISK AQ3 3380 017 024 XASRES R 

* 

USER $SPOOL$ NOLOG 

MDISK BQ1 3380 041 087 XASRES R 

* 


USER $T-DISK$ NOLOG 
MDISK BO1 3380 539 020 XASRES R 
* 


HAREKEI KERRIER EKREEREEEERERRRERREREKREREEREERERERERREEEEKRRKEKE 
* CMS USERIDS * 
HREKKKKKEERKHKEKEKEKERREKEREREREEREREREREREAEKERREEREEREREERERERER 
* 


USER CMS1 NOLOG 3M 32MG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT4 CMSTST 

IPL CMS 

CONSOLE 009 3215 

SPOOL @OC 2540 READER A 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 


* 
HHA RIKER IAAI IIR IRII AIA AISA IIIA IAI IIIA IAI IIASA NS SSN IN SAS ASIIAARI 
= PROP LOGICAL OPERATOR . 
HAKKAR KRIS IARI IAI AAI IIIA IAI IIA IIASA AISA AAT AAAI 
* 


USER LGLOPR NOLOG 512K 16M ABCDEG 
ACCOUNT ACT1 PROP 
IPL CMS 

CONSOLE 609 3215 

SPOOL OOC 2540 READER A 

SPOOL GOD 2540 PUNCH A 

SPOOL QOE 1403 A 

MDISK 191 3380 538 001 XASRES WR 
LINK MAINT 194 194 RR 

LINK MAINT 190 190 RR 

LINK OPERATOR 191 291 RR 
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USER DIRECT (3380) 


REKKKKEKEREEREREREEEEEREEEEREEKEEEEEEREREEREEEEEREREEKREEEEERRERE 


- SYSTEM RELATED USERIDS 


HRREKEREREEAREKEREEREEREREKREEEEREREREREERREEREREREEREEREREREREEK KKK 


* 


USER MAINT NOLOG 16M 32M ABCDEFG 


AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 

IPL 190 

NAMESAVE GCS 

NAMESAVE VTAM 

NAMESAVE HELP 

NAMESAVE INSTHELP 

CONSOLE 609 3215 T 

SPOOL OOC 2540 READER * 

SPOOL GOD 2540 PUNCH A 

SPOOL GOE 1403 A 

MDISK 123 3380 000 885 XASRES 
MDISK 124 3380 000 885 XAPO01 
MDISK 125 3380 600 885 XASERV 


MDISK 191 3380 694 030 XASRES 
MDISK 193 3380 128 046 XASRES 
MDISK 194 3380 416 056 XASRES 
MDISK 201 3380 001 022 XASERV 


MDISK 292 3380 023 020 XASERV 
MDISK 392 3380 043 020 XASERV 
MDISK 492 3380 063 010 XASERV 
MDISK 692 3380 073 010 XASERV 
MDISK 594 3380 083 075 XASERV 
MDISK 593 3380 173 090 XASERV 


MDISK 295 3380 559 013 XASRES 
MDISK 395 3380 572 010 XASRES 
MDISK 495 3380 263 605 XASERV 
MDISK 592 3380 268 010 XASERV 
MDISK 892 3380 278 005 XASERV 
MDISK 491 3380 283 008 XASERV 
MDISK 791 3380 291 012 XASERV 
MDISK 89E 3380 526 010 XASRES 
MDISK 896 3380 303 010 XASERV 
MDISK 895 3380 313 010 XASERV 


MDISK 499 3380 323 072 XASERV 
MDISK 423 3380 516 010 XASRES 
MDISK 293 3380 395 140 XASERV 
MDISK 294 3380 535 120 XASERV 
MDISK 393 3380 752 066 XASRES 
MDISK 394 3380 655 130 XASERV 
MDISK 19C 3380 194 040 XASRES 
MDISK 49C 3380 833 040 XASRES 


MDISK 291 3380 818 015 XASRES 
MDISK 391 3380 158 015 XASERV 
MDISK 591 3380 785 095 XASERV 
MDISK 691 3380 306 110 XASRES 
MDISK 49D 3380 582 040 XASRES 
MDISK 501 3380 646 002 XASRES 
MDISK 595 3380 622 012 XASRES 
MDISK 5E5 3380 873 605 XASRES 
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MW RMAINT 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW 
MW 


MW RCMSAUX WCMSAUX MCMSAUX 
WCPAUX MCPAUX 


MW RCPAUX 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


WMAINT MMAINT 


* 


De a i cr ee er a a ne 


MDISK 190 3380 234 072 XASRES MW ALL 
MDISK 19E 3380 650 044 XASRES MW ALL 
MDISK 19D 3380 476 040 XASRES MW ALL 
MDISK 596 3380 174 020 XASRES MW ALL 
MDISK 59E 3380 634 010 XASRES MW ALL 


* 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 


MDISK 36E 3380 644 002 XASRES RR RPVYM WPVM 
LINK RSCS 191 499 MW 
* 


USER CMSBATCH NOLOG 1M 2M G 
ACCOUNT 3 SYSTEM 
OPTION ACCT 
IPL CMS PARM AUTOCR 
CONSOLE 009 3215 
SPOOL GOC 2540 READER * 

SPOOL OOD 2540 PUNCH A 

SPOOL GOE 1403 A 

LINK MAINT 196 190 RR 

MDISK 195 3380 536 G02 XASRES MR RBATCH WBATCH 

* 

USER GCS NOLOG 16M 16M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT GCS RECVM 
IPL GCS 
NAMESAVE GCS 
CONSOLE 689 3215 
SPOOL OGC 2540 READER * 
SPOOL OGD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19D 19D RR 
LINK MAINT 595 595 
LINK MAINT 59E 59E 
MDISK 191 3380 472 004 XASRES MR RGCS WGCS MGCS 

* 

USER SYSMAINT NOLOG © 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 

IPL CMS 
CONSOLE 609 3215 T 
SPOOL G0C 2540 READER * 
SPOOL @6D 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 123 123 MW 
LINK MAINT 191 192 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER OPERATOR NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 2 OPERATOR 
CONSOLE 609 3215 T 
SPOOL GOC 2540 READER * 

SPOOL 00D 2540 PUNCH A 
SPOOL G0E 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 


MPVM 


MBATCH 


USER DIRECT (3380) 
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USER DIRECT (3380) 


LINK MAINT 19D 19D RR 

MDISK 191 3380 724 005 XASRES MR 
LINK OP1 191 192 RR 
* 


*QOP1 IS AN ALTERNATE OPERATOR USERID 
*x* 


USER OP1 NOLOG 3M 32M ABCDEFG 

AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 3 OPERATOR 

IPL CMS 

CONSOLE 009 3215 

SPOOL OGC 2540 READER * 

SPOOL OGD 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 1990 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3380 729 001 XASRES MR 

LINK OPERATOR 191 192 RR 
* 
* This userid is for the IBM CE's use in running 
* OLTSEP. 
* OLTSEP is automatically IPLed in the virtual machine. 
A minimum machine size of one megabyte is required to 
run OLTSEP. 
The privilege class of F allows the CE to specify 
intensive recording mode. 
The console address of 01F is required by OLTSEP. 
The unit record addresses are those required by 
OLTSEP. 

The 5FF minidisk is the CE's OLTSEP pack. 


t +€¢ &€ +& & & SF SF 


USER OLTSEP NOLOG 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT OLTSEP IBMCE 
IPL 5FF 
CONSOLE O1F 3215 
SPOOL GOC 2540 READER A 
SPOOL GOD 2540 PUNCH A 
SPOOL @OE 1403 A 
MDISK 5FF 3380 000 885 CEPACK MR 


** EREP ** 


+ + & 


* This userid is for the IBM CE's use in running 
* CPEREP. | 
* CMS is automatically IPLed in the virtual machine. 
* The 190 minidisk is the CMS system disk. 
* The 191 minidisk may be used to save often-used EREP 
* control statements and procedures (EXECs). 
* THE 190 MINIDISK HAS THE CMS TXTLIBS NECESSARY TO RUN 
* EREP, 
* 
USER EREP NOLOG 3M 8M BFG 

AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT EREP IBMCE 

IPL CMS 

CONSOLE O1F 3215 

SPOOL OGC 2540 READER A 

SPOOL OGD 2540 PUNCH B 
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USER DIRECT (3380) 


SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 201 201 RR 
MDISK 191 3380 750 002 XASRES WR READ WRITE MULTIPLE 
* 
USER OPERATNS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 OPERATNS 
IPL CMS 
CONSOLE 009 3215 
SPOOL @8C 2540 READER D 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 73@ 017 XASRES MR RDVF = WDVF = MDVF 


* 
* 


USER IPCS NOLOG 3M 8M BCEG 

AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 8 CE-ROOM 

IPL CMS 

CONSOLE 609 3215 

SPOOL G@C 2540 READER * 

SPOOL GOD 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 196 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

LINK OPERATNS 193 192 RR 
* 
USER AUTOLOG1 NOLOG 3M 8M ABCDEG 
AUTOLOG OP1 MAINT 
ACCOUNT 9 SYSTEM 

IPL CMS 
CONSOLE 069 3215 
SPOOL OGC 2540 READER * 
SPOOL QD 2540 PUNCH A 
SPOOL QQE 1403 A 
LINK MAINT 190 190 RR 
MDISK 191 3380 747 G01 XASRES MR RAUTOLOG WAUTOLOG MAUTOLOG 
: | 
USER DISKACNT NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 10 ACCNTNG 
IPL CMS 

CONSOLE 669 3215 

SPOOL GC 2540 READER * 
SPOOL GD 2540 PUNCH A 
SPOOL GQE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 
MDISK 191 3380 748 G01 XASRES MR READ WRITE MULTIPLE 


"ot 


USER IBMPSR NOLOG 3M 8M BG 
ACCOUNT 10 ACCNTNG 

IPL CMS 
CONSOLE 689 3215 
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USER DIRECT (3380) 


SPOOL GC 2540 READER * 

SPOOL OOD 2540 PUNCH A 

SPOOL GOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3380 749 001 XASRES WR 

* 

USER IVPM2 NOLOG 3M 4MG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACTS IVPM2 
CONSOLE 009 3215 
SPOOL GC 2540 READER A 
SPOOL GOD 2540 PUNCH A 
SPOOL OE 1403 A 
LINK MAINT 194 194 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19£ 19E RR 
LINK MAINT 19D 19D RR 

* 

USER VMUTIL NOLOG 3M 8M BDEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 11 SYSTEM 

IPL CMS 

CONSOLE 009 3215 

SPOOL OGC 2540 READER * 
SPOOL OGD 2540 PUNCH A 
SPOOL OE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER SYSDUMP1 NOLOG 3M 8M BG 

AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 12 SYSTEM 
IPL CMS 

CONSOLE 609 3215 

SPOOL GOC 2540 READER * 

SPOOL GOD 2540 PUNCH A 

SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

MDISK 123 3380 060 885 XASRES RR 

MDISK 124 3380 060 885 XAPOO1 RR 

MDISK 125 3380 G00 885 XASERV RR 


* 
* 


USER RSCS NOLOG 3M 8M 86 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 13 SYSTEM 

OPTION ACCT SVMSTAT LANG UCENG 
IUCV ANY 

NOPDATA 

* INCLUDE IF GCS NAMED SAVED SYSTEM IS RESTRICTED 
*NAMESAVE GCS 

IPL GCS PARM AUTOLOG 

CONSOLE O1F 3215 T OPERATOR 
SPOOL @OC 2540 READER A 

SPOOL OGD 2540 PUNCH A 
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en, ee oe ____.___ 


USER DIRECT (3380) 


SPOOL OOE 1403 E 

LINK MAINT 595 595 RR 

LINK MAINT 59F 191 RR 

LINK MAINT 190 190 RR 

LINK MAINT 193 193 RR 

LINK MAINT 19E 19E RR 

* Assigns real devices or communication lines at the specified 
* addresses to this virtual machine. 

*DEDICATE 740 740 

* 


USER PVM NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 14 SYSTEM 

IPL CMS 

CONSOLE 009 3215 

SPOOL O6C 2540 READER * 
SPOOL QOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK MAINT 36E 191 MR 


* 
* 
TTI TIT TIT TiC Titi TT titi tt titirri te rirrrrr rire e Torte co ret et 
° OTHER OPERATING SYSTEM USERIDS * 
HII KIKI IIIA IA IAI ISAS AIA II SII ISAS AS ASI AIAI SAINI AIA III 
* 
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XAMAINT Directory Entry (3380) 


Sample XAMAINT Directory Entry for a 3380 


If you are using the procedure in Chapter 4, “Installing VM/XA System Product Release 2.1 Using an 
Existing VM/SP or VM/SP HPO System” on page 215 to install your system, add the following entry to your 


I et re 


— ee cee oe eee eee ee eee eee — —— —_ =e «eee eooew ee ee 


ee et 


directory: 


* 


USER XAMAINT NOLOG 16M 16M ABCDEFG 


OPTION ECMODE DIAG98 
ACCOUNT 1 SYSPROG 

IPL 190 
*NAMESAVE GCS 
*NAMESAVE VTAM 
*NAMESAVE HELP 
*NAMESAVE INSTHELP 

CONSOLE 009 3215 T 

SPOOL G@C 2540 READER * 

SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 

MDISK 123 3380 600 885 XASRES 
MDISK 124 3380 060 885 XAPOO1 
MDISK 125 3380 000 885 XASERV 


MDISK 191 3380 694 030 XASRES 
MDISK 193 3380 128 046 XASRES 
MDISK 194 3380 416 056 XASRES 
MDISK 201 3380 601 022 XASERV 


MDISK 292 3380 023 020 XASERV 
MDISK 392 3380 043 020 XASERV 
MDISK 492 3380 063 010 XASERV 
MDISK 692 3380 073 010 XASERV 
MDISK 594 3380 083 075 XASERV 
MDISK 593 3380 173 090 XASERV 


MDISK 295 3380 559 013 XASRES 
MDISK 395 3380 572 010 XASRES 
MDISK 495 3380 263 005 XASERV 
MDISK 592 3380 268 010 XASERV 
MDISK 892 3380 278 005 XASERV 
MDISK 491 3380 283 008 XASERV 
MDISK 791 3380 291 012 XASERV 
MDISK 89E 3380 526 010 XASRES 
MDISK 896 3380 303 010 XASERV 
MDISK 895 3380 313 010 XASERV 


MDISK 490 3380 323 072 XASERV 
MDISK 423 3380 516 010 XASRES 
MDISK 293 3380 395 140 XASERV 
MDISK 294 3380 535 120 XASERV 
MDISK 393 3380 752 066 XASRES 
MDISK 394 3380 655 130 XASERV 
MDISK 19C 3380 194 040 XASRES 
MDISK 49C 3380 833 040 XASRES 


MDISK 291 3380 818 015 XASRES 
MDISK 391 3380 158 015 XASERV 
MDISK 591 3380 785 095 XASERV 
MDISK 691 3380 306 110 XASRES 
MDISK 49D 3380 582 040 XASRES 


788 


Installation and Service 


MW RMAINT 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW 
MW 


MW RCMSAUX WCMSAUX MCMSAUX 
WCPAUX MCPAUX 


MW RCPAUX 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


WMAINT MMAINT 


Ce cemenentiiceee ocean ae 


MDISK 501 3380 646 002 XASRES 
MDISK 595 3380 622 012 XASRES 
MDISK 5E5 3380 873 005 XASRES 


MDISK 190 3380 234 072 XASRES 
MDISK 19E 3380 650 044 XASRES 
MDISK 19D 3380 476 040 XASRES 
MDISK 596 3380 174 020 XASRES 
MDISK 59E 3380 634 010 XASRES 


* 


XAMAINT Directory Entry (3380) 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36E 3380 644 002 XASRES RR RPVM WPVM MPVM 


LINK RSCS 191 499 MW 
LINK MAINT 190 390 RR 
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XASRES Volume Allocation (3380) 


System Residence DASD Allocation for a 3380 


Figure 58 shows the allocation for the system residence device for the 3380 VM/XA SP starter system. The 
allocation and minidisk maps for the 3380-E4 (“System Residence DASD Allocation for a 3380-E4” on 

page 804 and “Minidisk Maps for a 3380-E4 System Residence Device” on page 805) and 3380-K (“System 
Residence DASD Allocation for a 3380-K” on page 818 and “Minidisk Maps for a 3380-K System Residence 
Device” on page 819) follow the corresponding sample directories (“Sample Directory for a 3380-E4” on 
page 793 and “Sample Directory for a 3380-K” on page 807, respectively). 


CYL CYL 

0009-0000 
0001-0602 
0003-0016 
6617-0040 


6041-0127 
0128-0538 
0539-0558 
0559-0884 


Figure 58. System Residence DASD Allocation for a 3380 
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Minidisk Maps for a 3380 System Residence Device 


Minidisk Maps (3380) 


Figure 59 shows the minidisk maps of the system residence device for the 3380. To map your own system 
residence device for comparison, issue DISKMAP fn DIRECT, where /n is the name of your directory. 


VOLUME 
CEPACK 


USERID 
OLTSEP 


cuU 
5FF 


DEVTYPE 


3380 


START 
0000 


VOLUME 
XAPO01 


USERID 


$ALLOC$ 


MAINT 


SYSDUMP1 


CUU 
Col 
124 
124 


DEVTYPE 


3380 
3380 
3380 


START 
0060 
0000 
6000 


0885 **0VERLAP** 
0885 **OVERLAP** 


VOLUME 
XASERV 


USERID 


$ALLOC$ 


MAINT 


MAINT 


SYSDUMP1 


125 
125 


DEVTYPE 


START 
6000 
0001 
0023 
0043 
0063 
0073 
0083 
0158 
0173 
0263 
0268 
0278 
0283 
0291 
0303 
0313 
0323 
0395 
0535 
0655 
0785 
6000 
0000 


0095 
Q885 **OVERLAP** 
0885 **OVERLAP** 


Figure 59 (Part | of 2). Minidisk Maps of the System Residence Device for a 3380 
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Minidisk Maps (3380) 


VOLUME 
XASRES 


USERID CUU DEVTYPE 
$ALLOC$ AQ1 3380 6000 O00 0001 
$DIRECT$  A04 3380 0001 Qb02 0002 
$CP-NUC$ AOS 3380 0603 0012 0010 
$SYSCKP$  A06 3380 0013 0014 0002 
$SYSWRM$ AQ7 3380 0015 0016 0002 
$PAGE$ AQ3 3380 0017 0040 0024 


$SPOOL$ BO1 3380 0041 0127 6087 


START END SIZE 


MAINT 193 3380 0128 0173 0046 
MAINT 596 3380 0174 Q193 0020 
MAINT 19C 3380 0194 0233 0040 
MAINT 190 3380 0234 0305 0072 
MAINT 691 3380 0306 0415 0110 
MAINT 194 3380 0416 0471 0056 
GCS 191 3380 0472 0475 0004 
MAINT 19D 3380 0476 0515 0040 
MAINT 423 3380 0516 Q525 0010 
MAINT 89E 3380 0526 Q535 0010 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| CMSBATCH 195 3380 0536 0537 0002 
| LGLOPR 191 3380 0538 0538 6001 
| $T-DISK$ BO 3380 0539 0558 6020 
| MAINT 295 3380 9559 0571 0013 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


MAINT 395 3380 0572 0581 0010 
MAINT 49D 3380 0582 0621 0040 
MAINT 595 3380 0622 0633 0012 
MAINT 59E 3380 0634 0643 0010 
MAINT 36E 3380 0644 0645 0002 
MAINT 501 3380 0646 0647 0002 
648 649 2 GAP 
MAINT 19E 3380 0650 0693 0044 
MAINT 191 3380 0694 0723 0030 
OPERATOR 191 3380 0724 0728 0005 
OP1 191 3380 0729 0729 6001 
OPERATNS 191 3380 0730 0746 6017 
AUTOLOG1 191 3380 0747 0747 6001 
DISKACNT 191 3380 0748 0748 6001 
IBMPSR 191 3380 0749 0749 6001 
EREP 191 3380 0750 Q751 0002 
MAINT 393 3380 Q752 0817 0066 
MAINT 291 3380 0818 0832 0015 
MAINT 49C 3380 0833 0872 0040 
MAINT 5E5 3380 0873 0877 0005 
MAINT 123 3380 0000 0884 0885 **OVERLAP** 


SYSDUMP1 123 3380 0000 0884 0885 **0VERLAP** 


Figure 59 (Part 2 of 2). Minidisk Maps of the System Residence Device for a 3380 
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USER DIRECT (3380-E4) 


Sample Directory for a 3380-E4 


This is only a sample file. You need to tailor it to your installation before it can be used. 
WHACK EAEEREREREKKA AER EEEREEEERERERREREREEEEEREKEE 


ig eee - 5664-308 - (c) COPYRIGHT IBM CORP.- 1988, 1989 * 
LICENSED MATERIAL - PROGRAM PROPERTY OF IBM * 
. SEE COPYRIGHT INSTRUCTIONS, 120-2083 " 


REKKKEREREEEEEEREEREEEEEEEEEEEREREERERERREEEEEERKEEERREEREERERKKEES 
RERKEEREEREEREEEERERREREREREREKEEREREREEEREREREKREREEREEEEEERREREEREE 


3380-E4 SYSTEM VM/XA SYSTEM PRODUCT DIRECTORY 

THE ADDRESSES 123, 124, AND 125 ARE VIRTUAL ADDRESSES. 

THE ADDRESS 123 IS CRITICAL SINCE IT IS USED IN HCPSYS AND 
THE DIRECTORY. IF YOU WANT TO CHANGE IT, REMEMBER IT MUST 
BE CHANGED IN HCPSYS, THE ‘DIRECTORY’ STATEMENT BELOW, 

AND IN THE 'MDISK' STATEMENTS FOR THE USERID 'MAINT'. 
NOTE: REMEMBER THESE ARE ONLY VIRTUAL ADDRESSES NOT REAL 
ADDRESSES, SO THERE IS NO NEED TO CHANGE THEM TO MATCH 
YOUR HARDWARE ADDRESSES. 


THIS DIRECTORY MUST BE MODIFIED IF MDISK PASSWORDS ARE TO 
BE SPECIFIED. WITHOUT MDISK PASSWORDS, MDISKS CANNOT BE 
SHARED USING THE 'CP LINK' COMMAND. A SAMPLE USER ENTRY 
FOLLOWS: (NOTE ONLY THE MDISK STATEMENT) 


USER ANYONE SOMEPASS 3M 8M FG 

AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 22227? 
IPL 190 
CONSOLE O1F 3215 
SPOOL GOC 2540 READER A 
SPOOL GOD 2540 PUNCH A 
SPOOL BOE 1403 A 

====> MDISK 999 33XX XXX YYY ZZZZZZ MR RPASS WPASS MPASS 


+ + ££ + + FH F $$ FF FE + F HF HF FHF HF HF HF HF HF F 


* 


WHERE: RPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
READ ONLY MODE. 
WPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
WRITE MODE. 
MPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
MULTI-WRITE MODE. 


+ £¢ * £€ ¢ £€ + ++ + © & & FF Fe HF HF HF FE He FF FF FE HF FE FO HF HF HF KH HF HF SF HF F 


NOTE: EACH PASSWORD MAY BE 1-8 CHARACTERS IN LENGTH. 


t+ + €£$ + £ + F SF SF F 


HREKEREKRKEKREEEKEKEKREEREEREEEKREKRKHREEREEERERREREEREREREREEEERERKEKE 


Following is a sample user entry and a brief description 
of each entry. A more detailed description may be found 
by referencing the VM/XA System Product Planning and 
Administration manual. 


USER CMS1 abcl123 3M 32M G 
- Userid is CMS1 
- Logon password is abc123 
- At logon time, virtual storage will equal 3M 
- Maximum storage that may be defined equals 32M 
- Privilege class is G 


+ + + * © & HF $F H& F EF HF HF HF F 
+e et © + £+ + + & FF HF HF HF HF F 


AUTOLOG AUTOLOGI OP1 MAINT 
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USER DIRECT (3380-E4) 


- Allows user CMS1 to be autolog'd by AUTOLOGI, 
OP1, and MAINT 


ACCOUNT ACT4 CMSTST 
- Time used by CMSi1 will be charged to account ACT4 
- Printed output will be sent to distribution CMSTST 


TPL CMS 
- Will cause automatic IPL of named save system of 
CMS 


CONSOLE 009 3215 
- Defines virtual machines console as a 3215 at a 
virtual address of 009 


SPOOL GOC 2540 READER A 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
- Defines virtual unit record devices of reader, 
punch, and printer with a spooling class of 'A' 


LINK MAINT 190 190 RR 
- Allows read access to minidisk 190 of user 'MAINT' 


LINK MAINT 19E 19E RR 
- Allows read access to minidisk 19E of user 'MAINT' 


LINK MAINT 19D 19D RR 
- Allows read access to minidisk 19d of user 'MAINT' 


MDISK 999 3350 236 022 CPPACK WR RPASS WPASS 

- Defines minidisk with a virtual address of 999 

- Specifies that the minidisk resides on a real 3350 

- Minidisk starts at cylinder 236 

- Mdisk is 22 cylinders in size (starting at cy] 236 

- The real volume serial number is ‘CPPACK' 

- Mdisk is to be accessed in write mode if no other 
user has write access. Alternate access read-only 

- RPASS is the required password for another user to 
link to this minidisk in read mode 

- WPASS is the required password for another user to 


link to this minidisk in write mode 
HRERKKEKRRAEEKEKKREKKEKKE KERR KKKKRKKKKKKK KKK 


* 
* 
* 


DIRECTORY 123 3380 XASRES 


* 


+ t+ + + © © F & *e & SF SF Fe HF FE SF Fe SE EF HE + He HH SE HF FOF He HF HE HF HF EF F HN F OF EH HF HF H HF 
¢ £¢ ££ + €¢ *€ $$ + + + HF Fe SF HF HF HH € FF HF HF SE HF He FE HF HF He SF SF HF HF FSF SF HF HF HF HF KH SF HF HF 


RERKEEEKEKKEEKEKEKREEERRREEEEEREERKEEREEERKEERKEEREAME KK KKK 
* SYSTEM RESERVED AREAS NOT FOR MINIDISKS * 
HREKKEKERKKREKEERKEKEKEREEKEREREKREKREREERREREREEERRKRRKKRRKKKKKKKEKE 
* 


USER $ALLOC$ NOLOG 

MDISK AQ1 3380 600 G01 XASRES R 
MDISK BO1 3380 000 001 XASERV R 
MDISK C01 3380 600 001 XAPOO1 R 


* 


USER $DIRECT$ NOLOG 
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USER DIRECT (3380-E4) 


MDISK AQ4 3380 001 002 XASRES R 
* 

USER $CP-NUC$ NOLOG 

MDISK AOS 3380 003 010 XASRES R 
* 


USER $SYSCKP$ NOLOG 
MDISK AQ6 3380 013 002 XASRES R 
* 


USER $SYSWRM$ NOLOG 

MDISK AQ7 3380 015 002 XASRES R 
* 

USER $PAGE$ NOLOG 

MDISK AO3 3380 017 024 XASRES R 
* 

USER $SPOOL$ NOLOG 

MDISK BQ1 3380 041 087 XASRES R 
* 

USER $T-DISK$ NOLOG 

MDISK B01 3380 539 020 XASRES R 
. 


HREREKRECEREKREREKEREREREEREREREERERREKREKEEERREEEREEKEREREEKRKEKN 
* CMS USERIDS * 
RHKKKKEKCKEKRR EKER RREREEEREERE 
* 


USER CMS1 NOLOG 3M 32MG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT4 CMSTST 

IPL CMS 
CONSOLE 069 3215 
SPOOL OOC 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19€ 19E RR 
LINK MAINT 19D 19D RR 


* 
HAKKEKEEEEKEKEKEEEEEKAEREERKEEREKEEREEREEEEEERERREEEEREERREREEEEEKEKKEE 
* PROP LOGICAL OPERATOR * 
KKKEKEKEEKREREKEEEEREREREREEEREERERERERREERERERERERREREREREEKREREEKEEEE 
: | 


USER LGLOPR NOLOG 512K 16M ABCDEG 
ACCOUNT ACT1 PROP 
IPL CMS 

CONSOLE 009 3215 

SPOOL OBC 2540 READER A 

SPOOL QOD 2540 PUNCH A 

SPOOL GOE 1403 A 

MDISK 191 3380 233 001 XASRES WR 
LINK MAINT 194 194 RR 

LINK MAINT 190 190 RR 

LINK OPERATOR 191 291 RR 


* 
AKEKKKEEKEKREEKEKEREEKEEREKEREREEREREEKREEREREKEERERREREREKEEEERES 
* SYSTEM RELATED USERIDS * 
HIKKEKEKAEUAEEAEEEEEEREEEEKKEEREERKEEEEEEREEKERERERERRKEERKEREEKE 
* 


USER MAINT NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 
IPL 190 
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USER DIRECT (3380-E4) . 


NAMESAVE GCS 

NAMESAVE VTAM 

NAMESAVE HELP 

NAMESAVE INSTHELP 
CONSOLE 009 3215 T 
SPOOL OGC 2540 READER * 
SPOOL G@D 2540 PUNCH A 
SPOOL OOE 1403 A 


MDISK 123 3380 6000 1770 XASRES MW 
MDISK 124 3380 0000 1770 XAPO01 RR 
MDISK 125 3380 6000 1770 XASERV RR 


MDISK 191 3380 @694 030 XASRES 
MDISK 193 3380 0128 046 XASRES 
MDISK 194 3380 0362 056 XASRES 
MDISK 201 3380 1711 622 XASRES 


MDISK 292 3380 1743 620 XASRES 
MDISK 392 3380 1453 020 XASRES 
MDISK 492 3380.1473 010 XASRES 
MDISK 692 3380 1483 010 XASRES 


MDISK 593 3380 1082 @S0 XASRES 
MDISK 594 3380 1007 075 XASRES 


MDISK 295 3380 1493 013 XASRES 
MDISK 395 3380 1506 010 XASRES 
MDISK 495 3380 0725 605 XASRES 
MDISK 592 3380 1523 010 XASRES 
MDISK 892 3380 1518 005 XASRES 
MDISK 491 3380 0527 008 XASRES 
MDISK 791 3380 1436 012 XASRES 
MDISK 89E 3380 1533 010 XASRES 
MDISK 5E5 3380 0458 G05 XASRES 
MDISK 896 3380 1543 010 XASRES 
MDISK 895 3380 1553 010 XASRES 


MDISK 490 3380 1573 072 XASRES 
MDISK 423 3380 1563 016 XASRES 
MDISK 293 3380 6747 140 XASRES 
MDISK 294 3380 0887 120 XASRES 
MDISK 393 3380 1645 066 XASRES 
MDISK 394 3380 0559 130 XASRES 
MDISK 19C 3380 1396 040 XASRES 
MDISK 49C 3380 0467 040 XASRES 
MDISK 596 3380 0507 020 XASRES 
MDISK 59E 3380 1733 010 XASRES 


MDISK 391 3380 0218 015 XASRES 
MDISK 591 3380 1172 095 XASRES 
MDISK 691 3380 1267 110 XASRES 
MDISK 49D 3380 0306 040 XASRES 
MDISK 501 3380 1394 G02 XASRES 
MDISK 595 3380 0346 012 XASRES 
MDISK 291 3380 1379 015 XASRES 


MDISK 190 3380 0234 072 XASRES 
MDISK 19E 3380 0174 044 XASRES 
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MW 
MW 
MW 
MW RMAINT WMAINT 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW 
MW 


MW RCMSAUX WCMSAUX MCMSAUX 
MCPAUX 


MW RCPAUX WCPAUX 


MW 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW 


MW ALL 
MW ALL 


MMAINT 


USER DIRECT (3380-E4) 


MDISK 19D 3380 0418 640 XASRES MW ALL 

* 

* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36E 3380 0537 602 XASRES RR RPVM WPVM = MPVM 
LINK RSCS 191 499 MW 

* 

USER CMSBATCH NOLOG 1M 2M G 
ACCOUNT 3 SYSTEM 
OPTION ACCT 
IPL CMS PARM AUTOCR 
CONSOLE 809 3215 
SPOOL O0C 2540 READER * 

SPOOL 60D 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

MDISK 195 3380 1377 002 XASRES MR RBATCH WBATCH MBATCH 
* 
USER GCS NOLOG 16M 16M ABCDEFG 

AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT GCS RECVM 

IPL GCS 

NAMESAVE GCS 

CONSOLE 609 3215 

SPOOL OGC 2540 READER * 

SPOOL OOD 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19D 19D RR 

LINK MAINT 595 595 

LINK MAINT 59E 59E 

MDISK 191 3380 463 G04 XASRES MR RGCS WGCS MGCS 

* 

USER SYSMAINT NOLOG © 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 

IPL CMS 
CONSOLE 609 3215 T 
SPOOL OOC 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 123 123 MW 
LINK MAINT 191 192 RR 
LINK MAINT 199 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER OPERATOR NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 2 OPERATOR 
CONSOLE 609 3215 T 
SPOOL OOC 2540 READER * 

SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

MDISK 191 3380 689 005 XASRES MR 
LINK OP1 191 192 RR 


* 


*OP1 IS AN ALTERNATE OPERATOR USERID 
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USER DIRECT (3380-E4) 


* 


U 


SER OP1 NOLOG 3M 32M ABCDEFG 


AUTOLOG AUTOLOG1 OP1 MAINT 


* 
* 
* 
* 
* 
* 
* 
* 


ACCOUNT 3 OPERATOR 

[IPL CMS 

CONSOLE 009 3215 

SPOOL OOC 2540 READER * 
SPCOL GOD 2540 PUNCH A 
SPOOL QOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 724 Q01 XASRES MR 
LINK OPERATOR 191 192 RR 


This userid is for the IBM CE's use in running 
OLTSEP. 

OLTSEP is automatically IPLed in the virtual machine. 
A minimum machine size of one megabyte is required to 
run OLTSEP. 

The privilege class of F allows the CE to specify 
intensive recording mode. 


* The console address of O1F is required by OLTSEP. 


* 
* 


* 
* 


U 


+ ££ & 


* 
* 
* 
* 
* 
* 
* 


* 
* 


U 


The unit record addresses are those required by 
OLTSEP. 
The 5FF minidisk is the CE's OLTSEP pack. 


SER OLTSEP NOLOG 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT OLTSEP IBMCE 

IPL 5FF 

CONSOLE 01F 3215 

SPOOL OC 2540 READER A 

SPOOL OGD 2540 PUNCH A 

SPOOL OOE 1403 A 

MDISK 5FF 3380 000 1770 CEPACK MR 


** EREP *# 


This userid is for the IBM CE's use in running 
CPEREP. 

CMS is automatically IPLed in the virtual machine. 
The 190 minidisk is the CMS system disk. 

The 191 minidisk may be used to save often-used EREP 
control statements and procedures (EXECs). 

THE 190 MINIDISK HAS THE CMS TXTLIBS NECESSARY TO RUN 
EREP. 


SER EREP NOLOG 3M 8M BFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT EREP IBMCE 
IPL CMS 

CONSOLE 01F 3215 

SPOOL O8C 2540 READER A 
SPOOL GOD 2540 PUNCH B 
SPOOL GOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 201 201 RR 
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MDISK 191 3380 1448 002 XASRES WR READ WRITE MULTIPLE 
* 


USER OPERATNS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OPi MAINT 
ACCOUNT 1 OPERATNS 
IPL CMS 
CONSOLE 009 3215 
SPOOL GOC 2540 READER D 
SPOOL GOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 730 017 XASRES MR RDVF WDVF MDVF 


* 
* 


USER IPCS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 8 CE-ROOM 

IPL CMS 
CONSOLE 609 3215 
SPOOL @GC 2540 READER * 
SPOOL 66D 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK OPERATNS 193 192 RR 

* 

USER AUTOLOG! NOLOG 3M 8M ABCDEG 
AUTOLOG OP1 MAINT 
ACCOUNT 9 SYSTEM 

IPL CMS 
CONSOLE 609 3215 
SPOOL G0C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 
MDISK 191 3380 535 601 XASRES MR RAUTOLOG WAUTOLOG MAUTOLOG 

* 

USER DISKACNT NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 10 ACCNTNG 

IPL CMS 
CONSOLE 689 3215 
SPOOL @@C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 536 001 XASRES MR READ WRITE MULTIPLE 

* 

USER IBMPSR NOLOG 3M 8M BG 
ACCOUNT 10 ACCNTNG 

IPL CMS 
CONSOLE 009 3215 
SPOOL G@C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 


USER DIRECT (3380-E4) 
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USER DIRECT (3380-E4) 


LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3380 1450 001 XASRES WR 
* 


USER IVPM2 NOLOG 3M 4MG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT5 IVPM2 
CONSOLE 069 3215 
SPOOL OGC 2540 READER A 
SPOOL 80D 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 194 194 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER VMUTIL NOLOG 3M 8M BDEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 11 SYSTEM 

IPL CMS 

CONSOLE 009 3215 

SPOOL @0C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPCOL QOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER SYSDUMP1 NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 12 SYSTEM 

IPL CMS 
CONSOLE 009 3215 
SPOOL Q0C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL @OE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 123 3380 000 1770 XASRES RR 
MDISK 124 3380 000 1770 XAPGO1 RR 
MDISK 125 3380 G00 1770 XASERV RR 


* 
* 


USER RSCS NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 13 SYSTEM 

OPTION ACCT SVMSTAT LANG UCENG 
TUCV ANY 

NOPDATA 

* INCLUDE IF GCS NAMED SAVED SYSTEM IS RESTRICTED 
*NAMESAVE GCS 

IPL GCS PARM AUTOLOG 

CONSOLE O1F 3215 T OPERATOR 
SPOOL GOC 2540 READER A 

SPOOL QOD 2540 PUNCH A 

SPOOL OOE 1403 E 

LINK MAINT 595 595 RR 

LINK MAINT 59F 191 RR 
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USER DIRECT (3380-E4) 


LINK MAINT 190 190 RR 

LINK MAINT 193 193 RR 

LINK MAINT 19E 19E RR 

* Assigns real devices or communication lines at the specified 
* addresses to this virtual machine. 

*DEDICATE 740 740 

* 


USER PVM NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 14 SYSTEM 

IPL CMS 
CONSOLE 669 3215 
SPOOL OGC 2540 READER * 
SPOOL OGD 2540 PUNCH A 7 
SPOOL OGE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK MAINT 36E 191 MR 


# 
* 
HHI IK III RIKKI IARI III ISI ASI IAI IIS ISA AI ASS IANA SISA SAN ISAS 
m OTHER OPERATING SYSTEM USERIDS = 
HHKKIIKIIAII INARI III III IAI III IAI AISI IAS AS AIS AS ASIAN IA ISIN ISSA: 
* 
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XAMAINT Directory Entry (3380-E4) 


Sample XAMAINT Directory Entry for a 3380-E4 


If you are using the procedure in Chapter 4, “Installing VM/XA System Product Release 2.1 Using an 
Existing VM/SP or VM/SP HPO System” on page 215 to install your system, add the following entry to your 
directory: 

* 


USER XAMAINT NOLOG 16M 16M ABCDEFG 
OPTION ECMODE DIAG98 

ACCOUNT 1 SYSPROG 

IPL 190 

*NAMESAVE GCS 

*NAMESAVE VTAM 

*NAMESAVE? HELP 

*NAMESAVE INSTHELP 


802 


CONSOLE 009 3215 T 
SPOOL OBC 2540 READER * 
SPOOL @@D 2540 PUNCH A 
SPOOL GOE 1403 A 


MDISK 123 3380 0000 1770 XASRES MW 
MDISK 124 3380 0000 1770 XAPGOQ1 RR 
MDISK 125 3380 0000 1776 XASERV RR 


MDISK 191 3380 0694 030 XASRES 
MDISK 193 3380 0128 046 XASRES 
MDISK 194 3380 0362 056 XASRES 
MDISK 201 3380 1711 022 XASRES 


MDISK 292 3380 1743 020 XASRES 
MDISK 392 3380 1453 020 XASRES 
MDISK 492 3380 1473 010 XASRES 
MDISK 692 3380 1483 010 XASRES 


MDISK 593 3380 1082 090 XASRES 
MDISK 594 3380 1007 075 XASRES 


MDISK 295 3380 1493 013 XASRES 
MDISK 395 3386 1506 010 XASRES 
MDISK 495 3380 0725 005 XASRES 
MDISK 592 3380 1523 010 XASRES 
MDISK 892 3380 1518 G05 XASRES 
MDISK 491 3380 0527 @08 XASRES 
MDISK 791 3380 1436 012 XASRES 
MDISK 89E 3380 1533 010 XASRES 
MDISK 5£5 3380 0458 @05 XASRES 
MDISK 896 3380 1543 010 XASRES 
MDISK 895 3380 1553 010 XASRES 


MDISK 490 3380 1573 072 XASRES 
MDISK 423 3380 1563 010 XASRES 
MDISK 293 3380 0747 140 XASRES 
MDISK 294 3380 0887 120 XASRES 
MDISK 393 3380 1645 066 XASRES 
MDISK 394 3380 0559 130 XASRES 
MDISK 19C 3380 1396 040 XASRES 
MDISK 49C 3380 0467 040 XASRES 
MDISK 596 3380 0507 020 XASRES 
MDISK 59E 3380 1733 010 XASRES 


MDISK 391 3380 0218 015 XASRES 
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MW 
MW 
MW 
MW RMAINT WMAINT 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW 
MW 


MW RCMSAUX WCMSAUX MCMSAUX 
WCPAUX MCPAUX 


MW RCPAUX 


MMAINT 


MDISK 591 3380 1172 695 XASRES 
MDISK 691 3380 1267 110 XASRES 
MDISK 49D 3380 0306 040 XASRES 
MDISK 501 3380 1394 002 XASRES 
MDISK 595 3380 0346 012 XASRES 
MDISK 291 3380 1379 015 XASRES 


MDISK 190 3380 0234 072 XASRES 
MDISK 19E 3380 0174 044 XASRES 
MDISK 19D 3380 0418 040 XASRES 


XAMAINT Directory Entry (3380-E4) 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW 


MW ALL 
MW ALL 
MW ALL 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 


MDISK 36E 3380 0537 002 XASRES RR RPVM WPVM MPVM 


LINK RSCS 191 499 MW 
LINK MAINT 190 390 RR 
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XASRES Volume Allocation (3380-E4) 


System Residence DASD Allocation for a 3380-E4 


Figure 60 shows the allocation for the system residence device for the 3380-E4 VM/XA SP Starter System. 


TYPE CYL CYL 
PERM 600-6800 
DRCT 0001-6602 
PERM 0003-6016 
PAGE 0017-0040 


SPOL 6041-0127 
PERM 0128-0538 
TDSK 0539-0558 
PERM 0559-1769 


Figure 60. System Residence DASD Allocation for a 3380-E4 
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Minidisk Maps for a 3380-E4 System Residence Device 


Minidisk Maps (3380-E4) 


Figure 61 shows the minidisk maps of the system residence device for the 3380-E4. To map your own system 
residence device for comparison, issue DISK MAP fn DIRECT, where fn is the name of your directory. 


CEPACK 


OLTSEP 


3380 


0000 


VOLUME 
XAPGO1 


USERID 
$ALLOC$ 
MAINT 
SYSDUMP1 


1770 


**QVERLAP** 
**QVERLAP** 


VOLUME 
XASERV 


USERID 
$ALLOC$ 
MAINT 
SYSDUMP1 


**QVERLAP** 
**QVERLAP** 


VOLUME 
XASRES 


USERID 
$ALLOC$ 
$DIRECT$ 
$CP-NUC$ 
$SYSCKP$ 
$SYSWRM$ 
$PAGE$ 
$SPOOL$ 


MAINT 
AUTOLOG1 


491 
191 


DEVTYPE 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 


3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 


0527 
0535 


| Figure 61 (Part 1 of 2). Minidisk Maps of the System Residence Device for a 3380-E4 
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Minidisk Maps (3380-E4) 


DISKACNT 191 3380 0536 0536 0001 


MAINT 36E 3380 0537 0538 0602 
$T-DISK$  BO1 3380 Q539 0558 0020 
MAINT 394 3380 Q559 0688 0130 
OPERATOR 191 3380 0689 0693 6005 
MAINT 191 3380 6694 0723 6030 
OP1 191 3380 0724 0724 6001 
MAINT 495 3380 0725 0729 6605 
OPERATNS 191 3380 0730 0746 0017 
MAINT 293 3380 0747 0886 0140 
MAINT 294 3380 0887 1006 0120 
MAINT 594 3380 1007 1081 6075 
MAINT 593 3380 1082 1171 6090 
MAINT 591 3380 1172 1266 0095 
MAINT 691 3380 1267 1376 0110 
CMSBATCH 195 3380 1377 1378 6002 
MAINT 291 3380 1379 1393 0015 
MAINT 501 3380 1394 1395 0602 
MAINT 19C 3380 1396 1435 0040 
MAINT 791 3380 1436 1447 0012 
EREP 191 3380 1448 1449 0002 
IBMPSR 191 3380 1450 1450 6001 
1451 1452 2 GAP 
MAINT 392 3380 1453 1472 0020 
MAINT 492 3380 1473 1482 0010 
MAINT 692 3380 1483 1492 0010 
MAINT 295 3380 1493 1505 0013 
MAINT 395 3380 1506 1515 0010 
1516 1517 2 GAP 
MAINT 892 3380 1518 1522 6005 
MAINT 592 3380 1523 1532 6010 
MAINT 89E 3380 1533 1542 6010 
MAINT 896 3380 1543 1552 6010 
MAINT 895 3380 1553 1562 0010 
MAINT 423 3380 1563 1572 0010 
MAINT 490 3380 1573 1644 0072 
MAINT 393 3380 1645 1710 0066 
MAINT 201 3380 1711 1732 6022 
MAINT 59E 3380 1733 1742 6010 
MAINT 292 3380 1743 1762 0020 
MAINT 123 3380 0600 1769 1770 **OVERLAP** 


SYSDUMP1 123 3380 #0000 #1769 1770 **OVERLAP** 


Figure 61 (Part 2 of 2). Minidisk Maps of the System Residence Device for a 3380-E4 
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USER DIRECT (3380-K) 


Sample Directory for a 3380-K 


This is only a sample file. You need to tailor it to your installation before it can be used. 
KHEAKKKEREKREREEREEEKREEKEEREREKREEEERRREERKERREREEEEEREEEERKKEE 


* COPYRIGHT - 5664-308 - (c) COPYRIGHT IBM CORP.- 1988, 1989 * 
x LICENSED MATERIAL - PROGRAM PROPERTY OF IBM . 
* SEE COPYRIGHT INSTRUCTIONS, G120-2083 x 


KRRKKKEREREKKEKEEEEREREREEERREEEEREEEREEEEEEKEEEREERREREEREEKREKKEE 
RKEKEKEKKEKEKREREKKEERERERERERKEEKEREREREREEEEERERREREREREKERREEKEN 


3380-3 SYSTEM VM/XA SYSTEM PRODUCT DIRECTORY 

THE ADDRESSES 123, 124, AND 125 ARE VIRTUAL ADDRESSES. 

THE ADDRESS 123 IS CRITICAL SINCE IT IS USED IN HCPSYS AND 
THE DIRECTORY. IF YOU WANT TO CHANGE IT, REMEMBER IT MUST 
BE CHANGED IN HCPSYS, THE ‘DIRECTORY' STATEMENT BELOW, 

AND IN THE 'MDISK’ STATEMENTS FOR THE USERID ‘MAINT'. 
NOTE: REMEMBER THESE ARE ONLY VIRTUAL ADDRESSES NOT REAL 
ADDRESSES, SO THERE IS NO NEED TO CHANGE THEM TO MATCH 
YOUR HARDWARE ADDRESSES. 


THIS DIRECTORY MUST BE MODIFIED IF MDISK PASSWORDS ARE TO 
BE SPECIFIED. WITHOUT MDISK PASSWORDS, MDISKS CANNOT BE 

SHARED USING THE 'CP LINK’ COMMAND. A SAMPLE USER ENTRY 

FOLLOWS: (NOTE ONLY THE MDISK STATEMENT) 


USER ANYONE SOMEPASS 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 727727 
IPL 190 
CONSOLE O1F 3215 
SPOOL O8C 2540 READER A 
SPOOL GOD 2540 PUNCH A 
SPOOL OOE 1403 A 
¥onen> MDISK 999 33XX XXX YYY ZZZZZZ MR RPASS WPASS MPASS 


t+ ¢ + + + &€ + &€ # & * FE FF HF HF HF F FF HF HF HF HF F 


WHERE: RPASS WILL BE THE REQUIRED PASSWORD TO LINK IN. 
READ ONLY MODE. 
WPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
WRITE MODE. 
MPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
MULTI-WRITE MODE. 


NOTE: EACH PASSWORD MAY BE 1-8 CHARACTERS IN LENGTH. 


+ + ¢ + €£$ ¢ + £ * € + + + F F&F + F HF F HF EF F&F $F FF SF $F HF OF SF HF HF HF FH 


+ + + €¢ + + ££ &F + F 


HREKKERKEEERREREREEKEREREEREEEEEREERREREEREKREERRERREREREREREERKEKER 


Following is a sample user entry and a brief description 
of each entry. A more detailed description may be found 
by referencing the VM/XA System Product Planning and 
Administration manual. 


USER CMS1 abc123 3M 32M G 
- Userid is CMS1 
- Logon password is abcl23 
- At logon time, virtual storage will equal 3M 
- Maximum storage that may be defined equals 32M 
- Privilege class is G 


¢ + + £¢ + + F&F F&F + + HF SF HF HF 
+ + *¢ €¢+ © © + © & € F&F & FF F F 


AUTOLOG AUTOLOG1 OP1 MAINT 
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USER DIRECT (3380-K) 


- Allows user CMS1 to be autolog'd by AUTOLOG1, 
OP1, and MAINT 


ACCOUNT ACT4 CMSTST 
- Time used by CMS1 will be charged to account ACT4 
- Printed output will be sent to distribution CMSTST 


IPL CMS 
- Will cause automatic IPL of named save system of 
CMS 


CONSOLE 009 3215 
- Defines virtual machines console as a 3215 at a 
virtual address of 009 


SPOOL GOC 2540 READER A 
SPOOL 00D 2540 PUNCH A 
SPOOL GOE 1403 A 
- Defines virtual unit record devices of reader, 
punch, and printer with a spooling class of ‘A' 


LINK MAINT 190 190 RR 
- Allows read access to minidisk 190 of user 'MAINT' 


LINK MAINT 19E 19E RR 
- Allows read access to minidisk 19E of user 'MAINT' 


LINK MAINT 19D 19D RR 
- Allows read access to minidisk 19d of user 'MAINT' 


MDISK 999 3350 236 022 CPPACK WR RPASS WPASS 

- Defines minidisk with a virtual address of 999 

- Specifies that the minidisk resides on a real 3350 

- Minidisk starts at cylinder 236 

- Mdisk is 22 cylinders in size (starting at cyl 236 

- The real volume serial number is 'CPPACK’' 

- Mdisk is to be accessed in write mode if no other 
user has write access. Alternate access read-only 

- RPASS is the required password for another user to 
link to this minidisk in read mode 

- WPASS is the required password for another user to 


link to this minidisk in write mode 
RAK RAK IK AKA KEKE KA HKEKK REECE KKK ER 


* 

* 

* 

DIRECTORY 123 3380 XASRES 

* 
RHEKKEKREEEKERKREREEREKRERERREERERERERERRERERREKRERERERERREREEKRKKE 
* SYSTEM RESERVED AREAS NOT FOR MINIDISKS * 
KARKKEKEKEREREKEEERKEKEEKEREKEEKERERREKEEEEREREREREEREEEEREKKKKK 
* 


USER $ALLOC$ NOLOG 

MDISK AO1 3380 000 601 XASRES R 
MDISK BQ1 3380 G00 001 XASERV R 
MDISK CO1 3380 GOO 601 XAPOO1 R 
* 


* ¢ + + * ££ £ FF HF HF HF He HF FH HF SF FE HH FF HF FE Fe SF HF HF SF HF SF eH HF HF HE HE HF SF HF HF HF HF HF HF 


* 
k 
* 
& 
* 
* 
# 
* 
* 
* 
k 
* 
* 
# 
7 
# 
* 
* 
* 
* 
* 
* 
t 
* 
” 
* 
* 
* 
* 
k 
* 
* 
* 
7 
x 
& 
* 
& 
* 
* 
* 
USER $DIRECT$ NOLOG 
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USER DIRECT (3380-K) 


MDISK AQ4 3380 001 602 XASRES R 
* 


USER $CP-NUC$ NOLOG 

MDISK AO9 3380 003 010 XASRES R 
* 

USER $SYSCKP$ NOLOG 

MDISK AGQ6 3380 013 002 XASRES R 
* 

USER $SYSWRM$ NOLOG 

MDISK AO7 3380 015 002 XASRES R 
* 


USER $PAGE$ NOLOG 

MDISK AQ3 3380 017 024 XASRES R 
* 

USER $SPOOL$ NOLOG 

MDISK BO1 3380 041 087 XASRES R 
* 

USER $T-DISK$ NOLOG 

MDISK BO1 3380 539 020 XASRES R 


* 
HEKKKREKEEREEEEKEEEERKEEEEEEERREEEEEEERREEERERREEEREREEERKREREREEEEE 
* CMS USERIDS * 
RKREKKREKEKEEEEREEEEKREEEEEEEEERREKEEEEREKEREEEEREERERERERRRERKERKEE 
* 


USER CMS1 NOLOG 3M 32MG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT4 CMSTST 

IPL CMS 
CONSOLE 009 3215 
SPOOL O0C 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 


* 
HEEKACCEKEER EEE REAEKKEEEREREEERREEEEREEREREREREREREREREEREREEREEEEEEEEE 
* PROP LOGICAL OPERATOR * 
HERKERRECKREREREEREEKEREEEREERRREEREREEKEEEEEREEREEREERERERREEKEEEEREEEEKEE 
* 


USER LGLOPR NOLOG 512K 16M ABCDEG 
ACCOUNT ACT1 PROP 
IPL CMS 

CONSOLE 009 3215 

SPOOL GOC 2540 READER A 

SPOOL GOD 2540 PUNCH A 

SPOOL OOE 1403 A 

MDISK 191 3380 532 GO1 XASRES WR 
LINK MAINT 194 194 RR 

LINK MAINT 190 190 RR 

LINK OPERATOR 191 291 RR 


* 
HKREREEREERKEKREEEEKEREEEEEREEEREEERERERRERERKEREREREREREERERRRKEEN 
* SYSTEM RELATED USERIDS * 
REKEKKKHAKRKEREREEEEEERREEKRERERERERERERKEEEERREERERERREKREKEEEKRKE 
* 


USER MAINT NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 
IPL 190 
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USER DIRECT (3380-K) 


NAMESAVE GCS 

NAMESAVE VTAM 

NAMESAVE HELP 

NAMESAVE INSTHELP 
CONSOLE 009 3215 T 
SPOOL 60C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 


MDISK 123 3380 0000 2655 XASRES MW 
MDISK 124 3380 00600 2655 XAPOQ1 RR 
MDISK 125 3380 0000 2655 XASERV RR 


MDISK 191 3380 0694 030 XASRES 
MDISK 193 3380 0176 Q46 XASRES 
MDISK 194 3380 0336 056 XASRES 
MDISK 201 3380 0787 022 XASRES 


MDISK 292 3380 08609 020 XASRES 
MDISK 392 3380 0128 020 XASRES 
MDISK 492 3380 0148 010 XASRES 
MDISK 692 3380 0851 010 XASRES 


MDISK 593 3380 0861 090 XASRES 
MDISK 594 3380 0951 075 XASRES 
MDISK 490 3380 1433 072 XASRES 
MDISK 423 3380 0166 010 XASRES 
MDISK 293 3380 0392 140 XASRES 
MDISK 294 3380 1093 120 XASRES 
MDISK 393 3380 1819 066 XASRES 
MDISK 394 3380 1213 130 XASRES 
MDISK 19C 3380 1343 040 XASRES 
MDISK 49C 3380 0747 040 XASRES 
MDISK 596 3380 1383 020 XASRES 
MDISK 59E 3380 1403 010 XASRES 
MDISK 5E5 3380 1572 005 XASRES 


MDISK 295 3380 1026 013 XASRES 
MDISK 395 3380 0829 010 XASRES 
MDISK 495 3380 1423 605 XASRES 
MDISK 592 3380 0673 010 XASRES 
MDISK 892 3380 1428 G05 XASRES 
MDISK 491 3380 0158 008 XASRES 
MDISK 791 3380 0222 012 XASRES 
MDISK 89E 3380 1530 010 XASRES 
MDISK 896 3380 1540 010 XASRES 
MDISK 895 3380 1550 010 XASRES 


MDISK 391 3380 0306 015 XASRES 
MDISK 591 3380 1577 095 XASRES 
MDISK 691 3380 0559 110 XASRES 
MDISK 49D 3380 1885 040 XASRES 
MDISK 501 3380 1672 002 XASRES 
MDISK 291 3380 0321 015 XASRES 
MDISK 595 3380 1560 012 XASRES 


MDISK 190 3380 0234 072 XASRES 


MDISK 19E 3380 
MDISK 19D 3380 


* 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 


1674 044 XASRES 
1925 040 XASRES 
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MW RMAINT WMAINT 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW 
MW 


MW RCMSAUX WCMSAUX MCMSAUX 
MCPAUX 


MW RCPAUX WCPAUX 


WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 


MW 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW 

MW READ WRITE MULTIPLE 


MW ALL 
MW ALL 
MW ALL 


MMAINT 


OO _ ____ _ —— ___  —  ———__ ___ T_T eee  ____) 


USER DIRECT (3380-K) 


MDISK 36E 3380 0537 602 XASRES RR RPYM WPVM MPVM 
LINK RSCS 191 499 MW 
* 


USER CMSBATCH NOLOG 1M 2M G 
ACCOUNT 3 SYSTEM 
OPTION ACCT 
IPL CMS PARM AUTOCR 
CONSOLE 009 3215 
SPOOL GOC 2540 READER * 

SPOOL GOD 2540 PUNCH A 

SPOOL OGE 1403 A 

LINK MAINT 190 190 RR 

MDISK 195 3380 533 692 XASRES MR RBATCH WBATCH MBATCH 

* 

USER GCS NOLOG 16M 16M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT GCS RECVM 
IPL GCS 
NAMESAVE GCS 
CONSOLE 609 3215 
SPOOL OOC 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL O0E 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19D 19D RR 
LINK MAINT 595 595 
LINK MAINT 59E 59E 
MDISK 191 3380 669 G04 XASRES MR RGCS WGCS MGCS 

* 

USER SYSMAINT NOLOG © 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 

IPL CMS 
CONSOLE 69 3215 T 
SPOOL OOC 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 123 123 MW 
LINK MAINT 191 192 RR 
LINK MAINT 190 199 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER OPERATOR NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 2 OPERATOR 
CONSOLE 699 3215 T 
SPOOL GOC 2540 READER * 

SPOOL 60D 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3380 725 005 XASRES MR 
LINK OP1 191 192 RR 


* 


*OP1 IS AN ALTERNATE OPERATOR USERID 
* 


USER OP1 NOLOG 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
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USER DIRECT (3380-K) 


* 


ACCOUNT 3 OPERATOR 

IPL CMS 

CONSOLE 009 3215 

SPOOL O@C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 724 G01 XASRES MR 
LINK OPERATOR 191 192 RR 


* This userid is for the IBM CE's use in running 


* 


OLTSEP. 


* OLTSEP is automatically IPLed in the virtual machine. 
* A minimum machine size of one megabyte is required to 
* run OLTSEP. 


* 
* 


The privilege class of F allows the CE to specify 
intensive recording mode. 


* The console address of O1F is required by OLTSEP. 


* 
* 
* 
* 


U 


+ £+ & 


* 
* 


The unit record addresses are those required by 
OLTSEP. 
The 5FF minidisk is the CE's OLTSEP pack. 


SER OLTSEP NOLOG 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT OLTSEP IBMCE 

IPL 5FF 

CONSOLE O1F 3215 

SPOOL O@C 2540 READER A 

SPOOL OGD 2540 PUNCH A 

SPOOL OOE 1403 A 

MDISK 5FF 3380 000 2655 CEPACK MR 


** EREP ** 


This userid is for the IBM CE's use in running 
CPEREP. 


* CMS is automatically IPLed in the virtual machine. 


* 
* 


The 190 minidisk is the CMS system disk. 
The 191 minidisk may be used to save often-used EREP 


* control statements and procedures (EXECs). 
* THE 190 MINIDISK HAS THE CMS TXTLIBS NECESSARY TO RUN 


* 
* 


U 


EREP. 


SER EREP NOLOG 3M 8M BFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT EREP IBMCE 
IPL CMS 

CONSOLE O1F 3215 

SPOOL O@C 2540 READER A 
SPOOL GOD 2540 PUNCH B 
SPOOL QOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 201 201 RR 
MDISK 191 3380 841 002 XASRES WR READ WRITE MULTIPLE 


* 


U 


SER OPERATNS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 OPERATNS 
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USER DIRECT (3380-K) 


IPL CMS 

CONSOLE 609 3215 

SPOOL O0C 2540 READER D 

SPOOL QOD 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3380 730 017 XASRES MR RDVF WDVF MDVF 


* 
* 


USER IPCS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 8 CE-ROOM 

IPL CMS 
CONSOLE 609 3215 
SPOOL OC 2540 READER * 
SPOOL OGD 2540 PUNCH A 
SPOOL QOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK OPERATNS 193 192 RR 

* 

USER AUTOLOG1 NOLOG 3M 8M ABCDEG 
AUTOLOG OP1 MAINT 
ACCOUNT 9 SYSTEM 

IPL CMS 
CONSOLE 009 3215 
SPOOL GOC 2540 READER * 
SPOOL 68D 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 
MDISK 191 3380 839 001 XASRES MR RAUTOLOG WAUTOLOG MAUTOLOG 

* 

USER DISKACNT NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 10 ACCNTNG 

IPL CMS 
CONSOLE 009 3215 
SPOOL G@C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 693 001 XASRES MR READ WRITE MULTIPLE 

* 

USER IBMPSR NOLOG 3M 8M BG 
ACCOUNT 10 ACCNTNG 

IPL CMS 

CONSOLE 669 3215 

SPOOL G8C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 

LINK MAINT 190 19@ RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
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USER DIRECT (3380-K) 


MDISK 191 3380 840 G61 XASRES WR 
* 


USER IVPM2 NOLOG 3M 4MG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT5 IVPM2 
CONSOLE 009 3215 
SPOOL GOC 2540 READER A 
SPGOL QOD 2540 PUNCH A 
SPOOL GQE 1403 A 
LINK MAINT 194 194 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER VMUTIL NOLOG 3M 8M BDEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 11 SYSTEM 

IPL CMS 

CONSOLE 609 3215 

SPOOL O0C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER SYSDUMP1 NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 12 SYSTEM 

IPL CMS 
CONSOLE 009 3215 
SPOOL GOC 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 123 3380 000 2655 XASRES RR 
MDISK 124 3380 0060 2655 XAPOO1 RR 
MDISK 125 3380 000 2655 XASERV RR 


* 
* 


USER RSCS NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 13 SYSTEM 

OPTION ACCT SVMSTAT LANG UCENG 
TUCV ANY 

NOPDATA 

* INCLUDE IF GCS NAMED SAVED SYSTEM IS RESTRICTED 
*NAMESAVE GCS 

IPL GCS PARM AUTOLOG 

CONSOLE 01F 3215 T OPERATOR 
SPOOL OGC 2540 READER A 

SPOOL OGD 2540 PUNCH A 

SPOOL QOE 1403 E 

LINK MAINT 595 595 RR 

LINK MAINT 59F 191 RR 

LINK MAINT 190 190 RR 

LINK MAINT 193 193 RR 

LINK MAINT 19E 19E RR 
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USER DIRECT (3380-K) 


* Assigns real devices or communication lines at the specified 
* addresses to this virtual machine. 
*DEDICATE 740 740 
* 
USER PVM NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 14 SYSTEM 
IPL CMS 
CONSOLE 009 3215 
SPOOL O0C 2540 READER * 
SPOOL QOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK MAINT 36£ 191 MR 


* 
* 
TT TTT TI TTI TTT ITT TTI Titi rliritrritritrtritrilitiir ret er etre Teer 
x OTHER OPERATING SYSTEM USERIDS x 
HHI IIH IIIA IRI IIIA III IIIA IISA SIS ISAS ASIN IASI ASIA AAIAAN ANISH 
* 
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XAMAINT Directory Entry (3380-K) 


Sample XAMAINT Directory Entry for a 3380-K 


If you are using the procedure in Chapter 4, “Installing VM/XA System Product Release 2.1 Using an 
Existing VM/SP or VM/SP HPO System” on page 215 to install your system, add the following entry to your 
directory: 

%* 


USER XAMAINT NOLOG 16M 16M ABCDEFG 
OPTION ECMODE DIAG98 

ACCOUNT 1 SYSPROG 

IPL 190 

*NAMESAVE GCS 

*NAMESAVE VTAM 

*NAMESAVE HELP 

*NAMESAVE INSTHELP 


$16 


CONSOLE 009 3215 T 
SPOOL COC 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL QOE 1403 A 


MDISK 123 3380 0060 2655 XASRES MW 
MDISK 124 3380 0000 2655 XAPOQ1 RR 
MDISK 125 3380 G0C0 2655 XASERV RR 


MDISK 191 3380 0694 03Q XASRES 
MDISK 193 3380 0176 046 XASRES 
MDISK 194 3380 0336 056 XASRES 
MDISK 201 3380 0787 022 XASRES 


MDISK 292 3380 0809 020 XASRES 
MDISK 392 3380 0128 020 XASRES 
MDISK 492 3380 0148 010 XASRES 


MDISK 692 3380 0851 010 XASRES 


MDISK 593 3380 0861 090 XASRES 
MDISK 594 3380 0951 075 XASRES 
MDISK 499 3380 1433 072 XASRES 
MDISK 423 3380 0166 010 XASRES 
MDISK 293 3380 0392 140 XASRES 
MDISK 294 3380 1093 120 XASRES 
MDISK 393 3380 1819 066 XASRES 
MDISK 394 3380 1213 130 XASRES 
MDISK 19C 3380 1343 040 XASRES 
MDISK 49C 3380 0747 040 XASRES 
MDISK 596 3380 1383 020 XASRES 
MDISK 59E 3380 1403 010 XASRES 
MDISK 5E5 3380 1572 005 XASRES 


MDISK 295 3380 1026 013 XASRES 
MDISK 395 3380 0829 010 XASRES 
MDISK 495 3380 1423 605 XASRES 
MDISK 592 3380 0673 010 XASRES 
MDISK 892 3380 1428 005 XASRES 
MDISK 491 3380 0158 008 XASRES 
MDISK 791 3380 0222 012 XASRES 
MDISK 89E 3380 1530 010 XASRES 
MDISK 896 3380 1540 010 XASRES 
MDISK 895 3380 1550 010 XASRES 


MDISK 391 3380 0306 015 XASRES 
MDISK 591 3380 1577 095 XASRES 


Installation and Service 


MW RMAINT WMAINT 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW 
MW 


MW RCMSAUX WCMSAUX MCMSAUX 
MCPAUX 


MW RCPAUX WCPAUX 


WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 
WR READ WRITE MULTIPLE 


MW 
MW READ WRITE MULTIPLE 


MMAINT 


meee ree 


comme ee ee 


MDISK 691 3380 0559 110 XASRES 
MDISK 49D 3380 1885 040 XASRES 
MDISK 501 3380 1672 002 XASRES 
MDISK 291 3380 0321 015 XASRES 
MDISK 595 3386 1560 012 XASRES 


MDISK 190 3380 0234 072 XASRES 
MDISK 19E 3380 1674 044 XASRES 
MDISK 19D 3380 1925 040 XASRES 


* 


XAMAINT Directory Entry (3380-K) 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW 

MW READ WRITE MULTIPLE 


MW ALL 
MW ALL 
MW ALL 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36E 3380 0537 002 XASRES RR RPVM WPVM MPVM 


LINK RSCS 191 499 MW 
LINK MAINT 190 390 RR 
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XASRES Volume Allocation (3380-K) 


System Residence DASD Allocation for a 3380-K 


Figure 62 shows the allocation for the system residence device for the 3380-K VM/XA SP Starter System. 


TYPE CYL CYL 
PERM 0060-0000 
DRCT 0001-0602 
PERM 0003-0016 
PAGE 0017-0040 


SPOL 6041-0127 
PERM 0128-0538 
TDSK 0539-0558 
PERM 0559-2654 


Figure 62. System Residence DASD Allocation for a 3380-K 


$18 Installation and Service 


Minidisk Maps for a 3380-K System Residence Device 


Minidisk Maps (3380-K) 


Figure 63 shows the minidisk maps of the system residence device for the 3380-K. To map your own system 
residence device for comparison, issue DISKMAP fn DIRECT, where fn is the name of your directory. 


VOLUME 
CEPACK 


USERID 
OLTSEP 


3380 


0069 


VOLUME 
XAP0Q1 


USERID 
$ALLOC$ 
MAINT 
SYSDUMP1 


C01 


**QVERLAP** 
**OVERLAP** 


VOLUME 
XASERV 


USERID 
$ALLOC$ 
MAINT 
SYSDUMP1 


2655 


**OVERLAP** 
**OVERLAP** 


See G2 eS SS HS SO 8 SS SS S88 SP SB SF SF SF SF SC SS SSF SF SF SOT BS SCSV*TWECQ OSA SO CFT SFOS FB SF FT SS SC Ts SF VS SOQVQI VFI SF FVII VWF FTF FO SF SSF es es 


VOLUME 
XASRES 


USERID 
$ALLOC$ 
$DIRECT$ 
$CP-NUC$ 
$SYSCKP$ 
$SYSWRM$ 
$PAGE$ 
$SPOOL$ 
MAINT 


LGLOPR 
CMSBATCH 


MAINT 
$T-DISK$ 


293 
191 
195 


36E 
BO1 


DEVTYPE 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3386 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 


3380 
3380 


0165 
9175 
0221 
0233 
0305 
0320 
0335 
0391 
0531 
0532 
0534 

936 
0538 
0558 


GAP 


Figure 63 (Part 1 of 2). Minidisk Maps of the System Residence Device for a 3380-K 
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Minidisk Maps (3380-K) 


MAINT 691 3380 0559 0668 0110 
GCS 191 3380 0669 0672 6004 
MAINT §92 3380 0673 0682 0010 
683 692 10 GAP 
DISKACNT 191 3380 0693 0693 0001 
MAINT 191 3380 0694 0723 0030 
OP1 191 3380 0724 0724 @001 


OPERATOR 191 3380 Q725 0729 G005 
OPERATNS 191 3380 0730 0746 6017 


MAINT 49C 3380 0747 0786 0040 
MAINT 201 3380 0787 0808 0022 
MAINT 292 3380 Q809 0828 0020 
MAINT 395 3380 Q829 0838 0010" 


AUTOLOG1 191 3380 0839 0839 Q001 
IBMPSR 191 3380 0840 0840 8001 


EREP 191 3380 0841 0842 6002 
843 850 8 GAP 
MAINT 692 3380 0851 0860 0010 
MAINT 593 3380 0861 0950 0090 
MAINT 594 3380 0951 1025 0075 
MAINT 295 3380 1026 1038 0013 
1039 1092 54 ~~ GAP 
MAINT 294 3380 1093 1212 0120 
MAINT 394 3380 1213 1342 0130 
MAINT 19C 3380 1343 1382 0040 
MAINT 596 3380 1383 1402 0020 
MAINT 59E 3380 1403 1412 0010 
1413 1422 10 GAP 
MAINT 495 3380 1423 1427 0605 
MAINT 892 3380 1428 1432 0005 
MAINT 490 3380 1433 1504 0072 
1505 1529 25 GAP 
MAINT 89E 3380 1530 1539 0010 
MAINT 896 3380 1540 1549 0010 
MAINT 895 3380 1550 1559 0010 
MAINT 595 3380 1560 1571 0012 
MAINT 5E5 3380 1572 1576 0005 
MAINT 591 3380 1577 1671 0095 
MAINT 501 3380 1672 1673 6002 
MAINT  19E 3380 1674 1717 6044 
1718 1818 101 GAP 
MAINT 393 3380 1819 1884 0066 
MAINT 49D 3380 1885 1924 0040 
MAINT 19D 3380 1925 1964 0040 
MAINT 123 3380 0000 2654 2655 **0VERLAP** 


SYSDUMP1 123 3380 #0000 ### 2654 = 2655 **OVERLAP** 


Figure 63 (Part 2 of 2). Minidisk Maps of the System Residence Device for a 3380-K 


$20 Installation and Service 


HCPSYS ASSEMBLE (3390) 


Sample Files for a 3390 Starter System 


IBM provides the following sample files with the VM/XA SP 3390 Starter System: 


HCPSYS ASSEMBLE for Starter System 
System directories for 3390 and 3391 

System residence DASD allocation 

Minidisk maps of the system residence device. 


Sample HCPSYS ASSEMBLE for a 3390 


This is only a sample file. You need to tailor it to your installation before it can be used. 
SYS TITLE 'HCPSYS90 - HCPSYS FOR VM/XA INSTALL BUILD' 


KREKEKEEKEKEKEEKREEEREEREEEREEEEREEKREREEEERKKEEKEEEEREREEEEEREEKERREREKKEKE 


* 5664-308 (C) COPYRIGHT IBM CORPORATION - 1989 “i 
* LICENSED MATERIALS - PROPERTY OF IBM * 
* SEE COPYRIGHT INSTRUCTIONS, G120-2083 - 


KRREKKREREKREKEREEEEREEEEEEEREEEEREREREEEREREEEEERERKEEERREREEREREEEEERKKES 
KRREKEKKREKKEKERKERKEREEEREREEEREREREEEEEREEEEEEEEEEREEREEERKEEEREE 
* 


* MODULE NAME - HCPSYS 


* 


* DESCRIPTIVE NAME - DEFINITION OF SYSTEM 


FUNCTION - TO DEFINE THE SYSTEM 


REGISTER CONVENTIONS - SYMBOLIC REFERENCES TO REGISTERS ARE 
OF THE FORM "RX" WHERE X IS A NUMBER 
RANGING FROM © TO 15 (SEE HCPEQUAT COPY) 


PATCH LABEL - NONE 
MODULE TYPE - DATA 
PROCESSOR - ASSEMBLER H (VERSION 2) 
ATTRIBUTES - RESIDENT, DATA-ONLY 
MACROS - 


SYSSTORE - DEFINE SYSTEM REAL STORAGE 

SYSRES - DEFINE SYSTEM RESIDENCE VOLUME 
SYSCPVOL - DEFINE SYSTEM VOLUMES 

SYSOPR - DEFINE SYSTEM OPERATOR 

SYSTIME - DEFINE THE TIME ZONE 

SYSACNT - DEFINE ACCOUNTING USERID 

SYSDUMP - DEFINE DUMP RECEIVER USERID 
SYSEREP - DEFINE EREP RECEIVER USERID 

SYSID - DEFINE SYSTEM ID'S BY PROCESSOR 
SYSUVOL - DEFINE USER VOLUMES TO BE MOUNTED 
SYSFCN - DEFINE PRIV CLASSES ASSIGNED TO CP FUNCTIONS 
SYSEND - END SYSTEM GENERATION 


¢ + + + + + + F $+ FE FF HF EF HE HF HF SF HF SF F FF HF F HF F F HF HF F F OH OF 


GENERAL COMMENTS - THIS MODULE IS THE USER'S RESPONSIBILITY. 
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HCPSYS ASSEMBLE (3390) 


* 


HCARAKKHKKEKRKEKKEEREEEREEEEREEEERERREEREEEEREREREEREEKEREEEKEEREREREEEREKEES 


SPACE 1 


* THE SYSTEM DEFINITION MACROS SYSSTORE, SYSRES, SYSCPVOL, 
* SYSOPR, AND SYSTIME, ARE CODED HERE, IN ANY ORDER 


SPACE 1 
SYSSTORE RMSIZE=32M, VRSIZE=8M, VRFREE=256 
SYSRES SYSVOL=XASRES, 
SYSRES=123, SYSTYPE=3390, 
SYSNUC=003, 
SYSCKP=(013,2), 
SYSWRM=(015 ,2) 
SYSTIME ZONE=5,LOC=WEST, ID=EST 
SYSOPR SYSOPER=OPERATOR 
SYSCPVOL XASRES,XASERV,XAPOO1, 


DRUMO1 , DRUMO2 , DRUMO3 , DRUMO4 , DRUMO5 , DRUMO6 , DRUMO7 , 
PAGOO1 , PAGOO2 , PAGOO3 , PAGO04 , PAGOO5 , PAGO06,, PAGOO7 , 


SPLOO1 , SPLOO2 , SPLOO3 , SPLO04 , SPLOO5 , SPLOO6, SPLOO7 
SPACE 1 


* ANY OF THE OPTIONAL MACROS THAT ARE DESIRED ARE CODED HERE, 
* IN ANY ORDER 


822 


SPACE 1 

SYSID DEFAULT=INSTTST, (3081A, 3081, 16000) 
SYSACNT USERID=DISKACNT 

SYSDUMP USERID=OPERATNS 

SYSEREP USERID=EREP 


+ £ + 


SYSUVOL USRPO1 , USRPO2 , USRPO3 , USRPO4 , USRPO5 , USRPO6 , USRPO7 , * 


USRPO8, USRPO9 
SYSFCN OPER=A,CPRD=CE,CPWT=C,SERV=F ,DFLT=G 
SPACE 1 


SPACE 1 
SYSEND 
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USER DIRECT (3390) 


There are two sets of sample directory, minidisk allocations, and minidisk maps for different models of 3390 
DASD. The first set (“Sample Directory for a 3390,” “System Residence DASD Allocation for a 3390” on 
page 834, and “Minidisk Maps for a 3390 System Residence Device” on page 835) is for the 3390. The 
second set (“Sample Directory for a 3391” on page 837, “System Residence DASD Allocation for a 3391” on 
page 847, and “Minidisk Maps for a 3391 System Residence Device” on page 848,) is for the 3391. 


Sample Directory for a 3390 


This is only a sample file. You need to tailor it to your installation before it can be used. 


KREKKEKKEKEKREEKEKEKEKEEKREREKERKEEREREEEREEREREEEEERUEEREREEREKREEE 


* COPYRIGHT - 5664-308 - (c) COPYRIGHT IBM CORP.- 1989 . 
* LICENSED MATERIAL - PROGRAM PROPERTY OF IBM * 
* SEE COPYRIGHT INSTRUCTIONS, 6120-2083 * 


HEEKREKEEKEREEKEEEEREEREREREEREREEKREREREERERREREREEEKRERERREREKEE 
RHREKREKRHEERREREEEKEREEEEREREREEREREEKREREEREKERRERERERREREERREREEKEE 


3390 SYSTEM VM/XA SYSTEM PRODUCT DIRECTORY 

THE ADDRESSES 123, 124, AND 125 ARE VIRTUAL ADDRESSES. 

THE ADDRESS 123 IS CRITICAL SINCE IT IS USED IN HCPSYS AND 
THE DIRECTORY. IF YOU WANT TO CHANGE IT, REMEMBER IT MUST 
BE CHANGED IN HCPSYS, THE 'DIRECTORY' STATEMENT BELOW, 

AND IN THE 'MDISK' STATEMENTS FOR THE USERID ‘MAINT’. 
NOTE: REMEMBER THESE ARE ONLY VIRTUAL ADDRESSES NOT REAL 
ADDRESSES, SO THERE IS NO NEED TO CHANGE THEM TO MATCH 
YOUR HARDWARE ADDRESSES. 


THIS DIRECTORY MUST BE MODIFIED IF MDISK PASSWORDS ARE TO 
BE SPECIFIED. WITHOUT MDISK PASSWORDS, MDISKS CANNOT BE 
SHARED USING THE 'CP LINK' COMMAND. A SAMPLE USER ENTRY 
FOLLOWS: (NOTE ONLY THE MDISK STATEMENT) 


USER ANYONE SOMEPASS 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 


IPL 190 
CONSOLE O1F 3215 
SPOOL GOC 2540 READER A 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
> MDISK 999 33XX XXX YYY ZZZZZZ MR RPASS WPASS MPASS 


t+ +e £¢ © + + © FF + HF HF HF F&F HF F SH FE HE F FF H HF H 


C3 


WHERE: RPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
READ ONLY MODE. 
WPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
WRITE MODE. 
MPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
MULTI-WRITE MODE. 


* + + + + + € + + * € F&F HH Fe F&F FF HF SF HF HF FE HF F HF FF HF F SF FF HF HF HF 


+ ¢ + + + e & H H FH 


NOTE: EACH PASSWORD MAY BE 1-8 CHARACTERS IN LENGTH. 


REKREKERREKREEEEEREKEREREEEREEREKREREREREERERREREKEEREREEKEREKRKEKKKE 


Following is a sample user entry and a brief description 
of each entry. A more detailed description may be found 
by referencing the VM/XA System Product Planning and 
Administration manual. 


+ + ¢ £€ + & & 
+ + + £ + & BH 


USER CMS1 abc123 3M 32MG 
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USER DIRECT (3390) 


- Userid is CMS1 

- Logon password is abcl23 

- At logon time, virtual storage will equal 3M 

- Maximum storage that may be defined equals 32M 
- Privilege class is G 


AUTOLOG AUTOLOG1 OP1 MAINT 
- Allows user CMS1 to be autolog'd by AUTOLOG1, 
OP1, and MAINT 


ACCOUNT ACT4 CMSTST 
- Time used by CMS1 will be charged to account ACT4 
- Printed output will be sent to distribution CMSTST 


IPL CMS 
- Will cause automatic IPL of named save system of 
CMS 


CONSOLE 069 3215 
- Defines virtual machines console as a 3215 at a 
virtual address of 009 


SPOOL GOC 2540 READER A 
SPOOL Q@0D 2540 PUNCH A 
SPOOL QOE 1403 A 
- Defines virtual unit record devices of reader, 
punch, and printer with a spooling class of ‘A’ 


LINK MAINT 190 190 RR 
- Allows read access to minidisk 190 of user 'MAINT' 


LINK MAINT 19E 19E RR 
- Allows read access to minidisk 19E of user 'MAINT' 


LINK MAINT 19D 19D RR 
- Allows read access to minidisk 19d of user 'MAINT' 


MDISK 999 3350 236 022 CPPACK WR RPASS WPASS 

- Defines minidisk with a virtual address of 999 

- Specifies that the minidisk resides on a real 3350 

- Minidisk starts at cylinder 236 

- Mdisk is 22 cylinders in size (starting at cyl 236 

- The real volume serial number is ‘CPPACK' 

- Mdisk is to be accessed in write mode if no other 
user has write access. Alternate access read-only 

- RPASS is the required password for another user to 
link to this minidisk in read mode 

- WPASS is the required password for another user to 


Tink to this minidisk in write mode 
REKEKREKKKREEERKKK KK KKK KKK KKK: 


* 


+ + + £ + + F F FF F HF HH F HF He FF HF FF HF FF HF HF HF SF SF HF FE HF F FF FF FF HF FF FF HF FF HF HF FH HF FH HF F F HF HF F 
+ £ + ££ & + & & *F + +F £ F&F FHF F FF HF HH FF HH F FE F HF HF SF HF Fe F SF F FF FE FE HF FHF FF HH FHF HF HF FE HF HF F 


* 
* 


DIRECTORY 123 3390 XASRES 
* 


REEKEKEKEEEEEEREEEEKERKREREKRREREREREEEEREREEREEEREEEREERKEREKKEEKE 


me SYSTEM RESERVED AREAS NOT FOR MINIDISKS € 


HNHREEKEREKKEKEEKEKEREEKEREEEEREEKERREKREKREKREREEEKEEEEEKEKRKEKKKKEK 
* 


USER $ALLOC$ NOLOG 
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——e ec re cw ree cm rm rm cme rm cm rm mmm mm crt mmm rr ie 


USER DIRECT (3390) 


MDISK A@1 3390 G00 001 XASRES 
MDISK B@1 3390 @00 001 XASERV 
MDISK C01 3390 600 001 XAPCO1 
* 

USER $DIRECT$ NOLOG 

MDISK AQ4 3390 G01 602 XASRES R 
* 

USER $CP-NUC$ NOLOG 

MDISK AO9 3390 003 010 XASRES R 
* 

USER $SYSCKP$ NOLOG 

MDISK AQ6 3390 @13 G02 XASRES R 
* 


y= 


USER $SYSWRM$ NOLOG 

MDISK AQ7 3390 615 002 XASRES R 
* 

USER $PAGE$  NOLOG 

MDISK AQ3. 3390 017 023 XASRES R 
* 


USER $SPOOL$ NOLOG 
MDISK BO1 3390 040 082 XASRES R 
* 


USER $T-DISK$ NOLOG 
MDISK BO1 3390 406 019 XASRES R fit 


* 
HAH KAKA RTE EREEKEREEEEEEREREEEERREERERREREEKEE 
* CMS USERIDS * 
RKAIKKHKAKRRERAK TKK REE EREREEEKREREREEEEREKKREREEKEE 
* 


USER CMS1 NOLOG 3M 32M G 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT4 CMSTST 

IPL CMS 
CONSOLE 609 3215 
SPOOL GOC 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 


* 
HHH HAART REET EERE 
* PROP LOGICAL OPERATOR * 
KRRAKEREKKECEREREKEEKREREREREEREREREEETRERREREKRERERRERREREREREREEERRAAER 
* 


USER LGLOPR NOLOG 512K 16M ABCDEG 
ACCOUNT ACT1 PROP 
IPL CMS 

CONSOLE 009 3215 

SPOOL OOC 2540 READER A 

SPOOL OOD 2540 PUNCH A 

SPOOL OOE 1403 A 

MDISK 191 3390 599 001 XASRES WR Ht 
LINK MAINT 194 194 RR 

LINK MAINT 190 196 RR 

LINK OPERATOR 191 291 RR 


* 
KRACKER EEKREEKEREREEEREREKREREERREREKREREREERKEREEE 


= SYSTEM RELATED USERIDS = 


HEEKEKREKREEEEKRERREEKEEEEKEERERREREREEREREEREREREEREREREREEREREEEEE 
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USER DIRECT (3390) 


* 


USER MAINT NOLOG 16M 32M ABCDEFG 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 

IPL 190 

NAMESAVE GCS 

NAMESAVE VTAM 

NAMESAVE HELP 

NAMESAVE INSTHELP 
CONSOLE 689 3215 T 
SPOOL OC 2540 READER * 
SPCOL 60D 2540 PUNCH A 
SPOOL OOE 1403 A 


MDISK 123 3390 0000 1113 XASRES MW 
MDISK 124 3390 0000 1113 XAPO01 RR 
MDISK 125 3390 G0C0 1113 XASERV RR 


MDISK 190 3390 0488 068 XASRES 
MDISK 191 3390 0444 028 XASRES 
MDISK 193 3390 0277 043 XASRES 
MDISK 194 3390 0210 053 XASRES 
MDISK 5E5 3390 0594 005 XASRES 
MDISK 19D 3390 0320 038 XASRES 
MDISK 19E 3390 0364 042 XASRES 
MDISK 291 3390 0604 014 XASRES 
MDISK 292 3390 0618 019 XASRES 
MDISK 391 3390 0263 014 XASRES 
MDISK 392 3390 0708 019 XASRES 
MDISK 423 3390 0260 010 XASRES 
MDISK 490 3390 0132 068 XASRES 
MDISK 492 3390 0727 010 XASRES 
MDISK 49D 3390 0556 038 XASRES 
MDISK 593 3390 0747 085 XASRES 
MDISK 594 3390 0637 071 XASRES 
MDISK 692 3390 0737 010 XASRES 


MDISK 19C 3390 0330 038 XASERV 


MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 


READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 


WR 


MDISK 201 3390 0601 021 XASERV 
MDISK 293 3390 0406 132 XASERV 
MDISK 294 3390 0538 113 XASERV 


MW RMAINT WMAINT MMAINT 
MW RCMSAUX WCMSAUX MCMSAUX 
MW RCPAUX WCPAUX MCPAUX 


eee cece ee ee ee ee ec ee eee eee eee 
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MDISK 295 3390 0842 013 XASRES 
MDISK 393 3390 0868 063 XASERV 
MDISK 394 3390 0077 123 XASERV 
MDISK 395-3390 0832 010 XASRES 
MDISK 491 3390 0200 008 XASERV 
MDISK 495 3390 0208 G05 XASERV 
MDISK 49C 3390 0368 038 XASERV 
MDISK 501 3390 0213 @02 XASERV 
MDISK 591 3380 0674 Q90 XASERV 
MDISK 592 3390 0215 019 XASERV 
MDISK 595 3390 0234 012 XASERV 
MDISK 596 3390 0246 019 XASERV 
MDISK 59E 3390 0265 012 XASERV 
MDISK 691 3390 0764 104 XASERV 
MDISK 791 3390 0277 012 XASERV 
MDISK 892 3390 0289 @05 XASERV 
MDISK 895 3390 6306 012 XASERV 
MDISK 896 3390 0318 012 XASERV 
MDISK 89£ 3390 0294 012 XASERV 
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MW READ WRITE MULTIPLE 
WR 

WR 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
WR 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
WR 

WR 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


USER DIRECT (3390) 


* 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36E 3390 0022 02 XASERV RR RPVM WPVM = MPV 
LINK RSCS 191 499 MW 

* 

USER CMSBATCH NOLOG 1M 2M G 
ACCOUNT 3 SYSTEM 
OPTION ACCT 
IPL CMS PARM AUTOCR 
CONSOLE 609 3215 
SPOOL GOC 2540 READER * 

SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 
MDISK 195 3390 602 002 XASRES MR RBATCH WBATCH MBATCH 
* 
USER GCS NOLOG 16M 16M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT GCS RECVM 
IPL GCS 
NAMESAVE GCS 
CONSOLE 009 3215 
SPOOL @8C 2540 READER * 
SPOOL 0D 2540 PUNCH A 
SPOOL OBE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19D 19D RR 
LINK MAINT 595 595 
LINK MAINT 59 59E 
MDISK 191 3390 358 @04 XASRES MR RGCS WGCS MGCS 

* 

USER SYSMAINT NOLOG © 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 

IPL CMS 
CONSOLE 609 3215 T 
SPOOL @8C 2540 READER * 
SPOOL @@D 2540 PUNCH A 
SPOOL OBOE 1403 A 
LINK MAINT 123 123 MW 
LINK MAINT 191 192 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

te 

USER OPERATOR NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 2 OPERATOR 
CONSOLE 609 3215 T 
SPOOL @8C 2540 READER * 

SPOOL OGD 2540 PUNCH A 
SPOOL GOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

MDISK 191 3390 122 @05 XASRES MR 
LINK OP1 191 192 RR 


* 


*OP1 IS AN ALTERNATE OPERATOR USERID 
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USER DIRECT (3390) 


* 


USER OP1 NOLOG 3M 32M ABCDEFG 

AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 3 OPERATOR 

IPL CMS 

CONSOLE 009 3215 

SPOOL QOC 2540 READER * 

SPOOL OOD 2540 PUNCH A 

SPOOL GOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3390 129 ©01 XASRES MR 

LINK OPERATOR 191 192 RR 
* 
* This userid is for the IBM CE's use in running 
* OLTSEP. 
* OLTSEP is automatically IPLed in the virtual machine. 
* A minimum machine size of one megabyte is required to 
* run OLTSEP. 
* The privilege class of F allows the CE to specify 
* intensive recording mode. 
* The console address of 01F is required by OLTSEP. 
* The unit record addresses are those required by 
* OLTSEP. 
* The 5FF minidisk is the CE's OLTSEP pack. 
* 


USER OLTSEP NOLOG 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT OLTSEP IBMCE 
IPL 5FF 
CONSOLE O1F 3215 
SPOOL OOC 2540 READER A 
SPOOL OGD 2540 PUNCH A 
SPOOL OOE 1403 A 
MDISK 5FF 3390 600 1113 CEPACK MR 


** EREP ** 


+ ££ * 


* This userid is for the IBM CE's use in running 

* CPEREP. 

* CMS is automatically IPLed in the virtual machine. 

* The 190 minidisk is the CMS system disk. 

* The 191 minidisk may be used to save often-used EREP 
* control statements and procedures (EXECs). 

* THE 190 MINIDISK HAS THE CMS TXTLIBS NECESSARY TO RUN 
* EREP. 

* 


USER EREP NOLOG 3M 8M BFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT EREP IBMCE 
IPL CMS 
CONSOLE O1F 3215 
SPOOL QOC 2540 READER A 
SPOOL 90D 2540 PUNCH B 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 201 201 RR 
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USER DIRECT (3390) 


MDISK 191 3390 127 GO2 XASRES WR READ WRITE = MULTIPLE 

, | 

USER OPERATNS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 OPERATNS 
IPL CMS 
CONSOLE 609 3215 
SPOOL O6C 2540 READER D 
SPOOL @GD 2540 PUNCH A 
SPOOL QQE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3390 472 016 XASRES MR RDVF  WOVF — MDVF 

* 

USER IPCS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 8 CE-ROOM 

IPL CMS 
CONSOLE 609 3215 
SPOOL OGC 2540 READER * 
SPOOL G6D 2540 PUNCH A 
SPOOL OOF 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19£ 19E RR 
LINK MAINT 19D 19D RR 
LINK OPERATNS 193 192 RR 

* 

USER AUTOLOG1 NOLOG 3M 8M ABCDEG 
AUTOLOG OP1 MAINT 
ACCOUNT 9 SYSTEM 

IPL CMS 
CONSOLE 609 3215 
SPOOL @@C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 
MDISK 191 3390 600 G01 XASRES MR RAUTOLOG WAUTOLOG MAUTOLOG 

* 

USER DISKACNT NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 10 ACCNTNG 

IPL CMS 
CONSOLE 699 3215 
SPOOL OOC 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL OE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19 RR 
LINK MAINT 19D 19D RR 
MDISK 191 3390 601 GO1 XASRES MR READ WRITE MULTIPLE 

* 

USER IBMPSR NOLOG 3M 8M BG 
ACCOUNT 10 ACCNTNG 

IPL CMS 
CONSOLE 089 3215 
SPOOL O@C 2540 READER * 
SPOOL OGD 2540 PUNCH A 
SPOOL O0E 1403 A 
LINK MAINT 190 190 RR 
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USER DIRECT (3390) 


LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3396 130 001 XASRES WR 
* 


USER IVPM2 NOLOG 3M 4M G 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACTS IVPM2 
CONSOLE 009 3215 
SPOOL G@C 2540 READER A 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 194 194 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER VMUTIL NOLOG 3M 8M BDEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 11 SYSTEM 

IPL CMS 

CONSOLE 609 3215 

SPOOL @GC 2540 READER * 
SPOOL @6D 2540 PUNCH A 
SPOOL @0E 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER SYSDUMP1 NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 12 SYSTEM 

IPL CMS 
CONSOLE 009 3215 
SPOOL G@C 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 123 3390 600 1113 XASRES RR 
MDISK 124 3390 @6@ 1113 XAPOO1 RR 
MDISK 125 3390 000 1113 XASERV RR 


* 
* 


USER RSCS = NOLOG 3M 8M 8G 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 13 SYSTEM 

OPTION ACCT SVMSTAT LANG UCENG 
IUCV ANY 

NOPDATA 

* INCLUDE IF GCS NAMED SAVED SYSTEM IS RESTRICTED 
*NAMESAVE GCS 

IPL GCS PARM AUTOLOG 

CONSOLE 01F 3215 T OPERATOR 
SPOOL GOC 2540 READER A 

SPOOL OGD 2540 PUNCH A 

SPOOL QOE 1403 E 

LINK MAINT 595 595 RR 

LINK MAINT 59F 191 RR 

LINK MAINT 190 190 RR 
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USER DIRECT (3390) 


LINK MAINT 193 193 RR 

LINK MAINT 19€ 19E RR 
* Assigns real devices or communication lines at the specified 
* addresses to this virtual machine. 
*DEDICATE 740 740 
* 
USER PVM NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 14 SYSTEM 

IPL CMS 

CONSOLE 609 3215 

SPOOL OO6C 2540 READER * 

SPOOL OOD 2540 PUNCH A 

SPOOL GOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

LINK MAINT 36E€ 191 MR 


* 
* 
HEAREKEREEKEKEEKEEEREREKREREKERREREREEEREEREREREEREREEREEEREREEKE 
* OTHER OPERATING SYSTEM USERIDS * 
KHAKI KEKEEEKRAEEEKRREEKRKEKAEREREKECRREREEKKEEEREERKKAKKERKKKK 
* 


Appendix C. VM/XA System Product Starter System Information 831 


rd 


XAMAINT Directory Entry (3390) 


Sample XAMAINT Directory Entry for a 3390 


If you are using the procedure in Chapter 4, “Installing VM/XA System Product Release 2.1 Using an 
Existing VM/SP or VM/SP HPO System” on page 215 to install your system, add the following entry to your 


directory: 


* 


USER XAMAINT NOLOG 16M 16M ABCDEFG 


OPTION ECMODE DIAG98 
ACCOUNT 1 SYSPROG 

IPL 190 
*NAMESAVE GCS 
*NAMESAVE VTAM 
*NAMESAVE HELP 
*NAMESAVE INSTHELP 
CONSOLE 609 3215 T 
SPOOL GOC 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL OOE 1403 A 


MDISK 123 3390 0000 1113 XASRES MW 
MDISK 124 3390 0600 1113 XAPQO1 RR 
MDISK 125 3390 0000 1113 XASERV RR 


MDISK 190 3390 0488 068 XASRES 
MDISK 191 3390 0444 028 XASRES 
MDISK 193 3390 0277 043 XASRES 
MDISK 194 3390 0210 053 XASRES 
MDISK 5E5 3390 0594 005 XASRES 
MDISK 19D 3390 0320 038 XASRES 
MDISK 19E 3390 0364 042 XASRES 
MDISK 291 3390 0604 014 XASRES 
MDISK 292 3390 0618 019 XASRES 
MDISK 391 3390 0263 014 XASRES 
MDISK 392 3390 0708 019 XASRES 
MDISK 423 3390 0200 010 XASRES 
MDISK 490 3390 0132 068 XASRES 
MDISK 492 3390 0727 010 XASRES 
MDISK 49D 3390 0556 038 XASRES 
MDISK 593 3390 0747 085 XASRES 
MDISK 594 3390 0637 071 XASRES 
MDISK 692 3390 0737 010 XASRES 


MDISK 19C 3390 0330 038 XASERV 


MW READ WRITE MULTIPLE 
MW 

MW READ WRITE MULTIPLE 
MW 

MW 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


WR 


MDISK 201 3390 9001 021 XASERV MW RMAINT WMAINT MMAINT 
MDISK 293 3390 0406 132 XASERV MW RCMSAUX WCMSAUX MCMSAUX 
MDISK 294 3390 0538 113 XASERV MW RCPAUX WCPAUX MCPAUX 


MDISK 295 3390 0842 013 XASRES 
MDISK 393 3390 0868 063 XASERV 
MDISK 394 3390 0077 123 XASERV 
MDISK 395 3390 0832 010 XASRES 
MDISK 491 3390 0200 008 XASERV 
MDISK 495 3390 0208 005 XASERV 
MDISK 49C 3390 0368 038 XASERV 
MDISK 501 3390 0213 002 XASERV 
MDISK 591 3390 0674 090 XASERV 
MDISK 592 3390 0215 019 XASERV 
MDISK 595 3390 0234 012 XASERV 
MDISK 596 3390 0246 019 XASERV 
MDISK 59E 3390 0265 012 XASERV 
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MW READ WRITE MULTIPLE 
WR 
WR 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
WR 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
WR 
WR 


MDISK 691 3390 0764 104 XASERV 
MDISK 791 3390 0277 012 XASERV 
MDISK 892 3390 0289 605 XASERV 
MDISK 895 3390 0306 012 XASERV 
MDISK 896 3390 0318 012 XASERV 
MDISK 89E 3390 0294 012 XASERV 


*& 


XAMAINT Directory Entry (3390) 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36E 3390 0022 @02 XASERV RR RPVM WPVM MPVM 


LINK RSCS 191 499 Mw 
LINK MAINT 190 390 RR 
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XASRES Volume Allocation (3390) 


System Residence DASD Allocation for a 3390 


Figure 64 shows the allocation for the system residence device for the 3390 VM/XA SP starter system. The 
allocation and minidisk maps for the 3391 (“System Residence DASD Allocation for a 3391” on page 847 
and “Minidisk Maps for a 3391 System Residence Device” on page 848) follow the corresponding sample 
directories (“Sample Directory for a 3391” on page 837 and “Sample XAMAINT Directory Entry for a 
3391” on page 845, respectively). 


CYL CYL 

0000-0000 
6001-002 
8003-0016 
6017-0039 


0040-0121 
0122 0405 
0406-0424 
0425-1113 


Figure 64. System Residence DASD Allocation for a 3390 
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Minidisk Maps (3390) 


| Minidisk Maps for a 3390 System Residence Device 


Figure 65 shows the minidisk maps of the system residence device for the 3390. To map your own system 
| residence device for comparison, issue DISKMAP fn DIRECT, where fn is the name of your directory. 


VOLUME 
CEPACK 


USERID 
OLTSEP 


CUU 
SFF 


DEVTYPE 


3390 


START END SIZE 
0000 1112 1113 


VOLUME 
XAPOO1 


USERID 
$ALLOC$ 
MAINT 
SYSDUMP1 


CUU 
Col 
124 
124 


DEVTYPE 


3390 
3390 
3390 


START END SIZE 
6000 8060 6001 
8000 1112 1113 **0VERLAP** 
6000 1112 1113 **QVERLAP** 


VOLUME 
XASERV 


$ALLOC$ 


SYSDUMP1 


CUU 
BO1 
201 
36E 


394 
491 
495 
501 
§92 
595 
596 
59E 
791 
892 
89E 
895 
896 
19C 
49C 
293 
294 


591 
691 
393 
125 
125 


DEVTYPE 


3390 
3390 
3390 


3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 


3390 
3390 
3390 
3390 
3390 


START END SIZE 


24 76 53 GAP 


0289 0293 6005 
0294 0305 0012 
0306 0317 0012 
0318 0329 0012 
0330 0367 0038 
0368 0405 0038 
0406 0537 0132 
0538 0650 0113 
651 673 23 GAP 
0674 0763 0090 
0764 0867 0104 
0868 0930 0063 
0800 1112 1113 **OVERLAP** 
“8000 1112 1113 **QVERLAP** 


Figure 65 (Part 1 of 2). Minidisk Maps of the System Residence Device for a 3390 
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| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


Minidisk Maps (3390) 


VOLUME 
XASRES 


USERID 
$ALLOC$ 
$DIRECT$ 
$CP-NUC$ 
$SYSCKP$ 
$SYSWRM$ 
$PAGE$ 
$SPOOL$ 
OPERATOR 
EREP 

OP1 
IBMPSR 


MAINT 
MAINT 
MAINT 
MAINT 
MAINT 
MAINT 
GCS 


MAINT 
$T-DISK$ 


MAINT 
OPERATNS 
MAINT 
MAINT 
MAINT 
LGLOPR 
AUTOLOG1 
DISKACNT 
CMSBATCH 


MAINT 
SYSDUMP1 


CUU 
AQ1 
A04 
AQ9 
A06 
AQ? 


123 


DEVTYPE 


3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 


START 
9800 
g001 

0003 
6013 
0015 
@017 
e040 
9122 
0127 
9129 
0130 

131 
9132 
0200 
0210 
0263 
0277 
0320 
0358 

362 
0364 
0406 

425 
0444 
0472 
0488 
0556 
9594 
9599 
0600 
0601 
0602 
9604 
0618 
0637 
0708 
0727 
0737 
0747 
9832 
0842 
e000 
e600 


1113 **0VERLAP** 
1113 **0VERLAP** 


Figure 65 (Part 2 of 2). Minidisk Maps of the System Residence Device for a 3390 
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—— ew wr cm cm cw ccm ccm crm cm cr wm crm mm mw we ww eee ee — 


USER DIRECT (3391) 


Sample Directory for a 3391 


This is only a sample file. You need to tailor it to your installation before it can be used. 


kkkkkkekk 


- ene 


* 
RXKKKKKKK 


KHKAEKKEEREKERKREKREREREEREEREERKEEREREEREKAEEERERKEREREKEEE 


HT - 5664-308 - (c) COPYRIGHT IBM CORP.- 1989 i 
LICENSED MATERIAL - PROGRAM PROPERTY OF IBM 
SEE COPYRIGHT INSTRUCTIONS, 6120-2083 i 


KEKEKKEKKKREKEKEKEKREEKREEEKEEEREREEREREKEEREEREREREKKEKEE 


REKKEKKEKEREEKKEEKEREEEEKEREKEKREREREKREEREREREREKRREEEEEEEEREREE 


3390 S 


THE DI 
AND IN 


NOTE: 
ADDRES 


US 


+ + £ & F & € + F HF SF FS FF FF FE $F FH F $F HF F HF F 


*====> 


+ £ + + + © + F HF F 


NOTE: 


kkhkkkkeekk 


Admini 


-_ 
-_ 
- 
-= 


*+ + + + + ££ F€ $+ + HH HF F SF HF F 


THE ADDRESSES 123, 124, AND 125 ARE VIRTUAL ADDRESSES. 
THE ADDRESS 123 IS CRITICAL SINCE IT IS USED IN HCPSYS AND 


BE CHANGED IN HCPSYS, THE 'DIRECTORY' STATEMENT BELOW, 


YOUR HARDWARE ADDRESSES. 


THIS DIRECTORY MUST BE MODIFIED IF MDISK PASSWORDS ARE TO 
BE SPECIFIED. WITHOUT MDISK PASSWORDS, MDISKS CANNOT BE 
SHARED USING THE 'CP LINK' COMMAND. A SAMPLE USER ENTRY 
FOLLOWS: (NOTE ONLY THE MDISK STATEMENT) 


AUTOLOG AUTOLOG1 OP1 MAINT 


WHERE: RPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 


Following is a sample user entry and a brief description 
of each entry. A more detailed description may be found 
by referencing the VM/XA System Product Planning and 


USER CMS1 abcl23 3M 32M G 


AUTOLOG AUTOLOG1 OP1 MAINT 


YSTEM VM/XA SYSTEM PRODUCT DIRECTORY 


RECTORY. IF YOU WANT TO CHANGE IT, REMEMBER IT MUST 


THE 'MDISK' STATEMENTS FOR THE USERID ‘MAINT’. 
REMEMBER THESE ARE ONLY VIRTUAL ADDRESSES NOT REAL 
SES, SO THERE 1S NO NEED TO CHANGE THEM TO MATCH 


ER ANYONE SOMEPASS 3M 8M FG 


ACCOUNT 272777 

IPL 190 

CONSOLE O1F 3215 

SPOOL @OC 2540 READER A 

SPOOL GOD 2540 PUNCH A 

SPOOL OOE 1403 A 

MDISK 999 33XX XXX YYY ZZZZZZ MR RPASS WPASS MPASS 


READ ONLY MODE. 

WPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
WRITE MODE. 

MPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
MULTI-WRITE MODE. 


¢ $+ + + € FF HF HF HF HF HF HF FE F F&F FE HF FE HF FF HE HF HF F HF HF HF HE * HF FH KF 


EACH PASSWORD MAY BE 1-8 CHARACTERS IN LENGTH. 


HREEKKKKEKEKKEEKEA KKK KERR 


stration manual. 


Userid is CMS1 

Logon password is abcl23 

At logon time, virtual storage will equal 3M 
Maximum storage that may be defined equals 32M 
Privilege class is G 


+ + + ee HF + Ft FH FH Fe HF HF HF F F 
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USER DIRECT (3391) 


- Allows user CMS1 to be autolog'd by AUTOLOG), 
OP1, and MAINT 


ACCOUNT ACT4 CMSTST 
- Time used by CMS1 will be charged to account ACT4 
- Printed output will be sent to distribution CMSTST 


IPL CMS 
- Will cause automatic IPL of named save system of 
CMS 


CONSOLE 009 3215 
- Defines virtual machines console as a 3215 at a 
virtual address of 009 


SPOOL GOC 2540 READER A 
SPOOL GOD 2540 PUNCH A 
SPOOL OOE 1403 A 
- Defines virtual unit record devices of reader, 
punch, and printer with a spooling class of 'A' 


LINK MAINT 190 190 RR 
- Allows read access to minidisk 190 of user 'MAINT' 


LINK MAINT 19E 19E RR 
- Allows read access to minidisk 19E of user 'MAINT' 


LINK MAINT 19D 19D RR 
- Allows read access to minidisk 19d of user 'MAINT' 


MDISK 999 3350 236 022 CPPACK WR RPASS WPASS 

- Defines minidisk with a virtual address of 999 

- Specifies that the minidisk resides on a real 3350 

- Minidisk starts at cylinder 236 

- Mdisk is 22 cylinders in size (starting at cyl 236 

- The real volume serial number is 'CPPACK' 

- Mdisk is to be accessed in write mode if no other 
user has write access. Alternate access read-only 

- RPASS is the required password for another user to 
link to this minidisk in read mode 

- WPASS is the required password for another user to 


link to this minidisk in write mode 
KkkkKaRKKRKKRRKRK KKK KKK RRR KKK KR KKK 


* 
* 
* 


DIRECTORY 123 3390 XASRES 
* 


+ + + + & & € € * FF FF HF HF FF HF F HF HF F F&F HF FF HF FHF F HE HF HF HF HF HF HF HK OF KF KF HF OF F HF HR F 
+ t+ + + + Fe HF HF He HF HH HF HF FF F&F HF KF HF HF HF FH FE FF HF HF HF HE HF HF FF HF HF SF FF EF HF F F HF 


HRRAKARERERIRERERIENIAIA SIA IIIA IAI AIA IA IASI IIIA AIS AS IS INADA AI I 
gl SYSTEM RESERVED AREAS NOT FOR MINIDISKS sj 
HHRKKAKRERERIKR IIASA RIA IAIA IIIA NAIA IIIS AISI ASIII SIA INIA ISAS 
* 


USER $ALLOC$ NOLOG 

MDISK AQ1 3390 000 001 XASRES R 
MDISK BO1 3390 600 001 XASERV R 
MDISK C01 3390 G00 601 XAPOO1 R 
* 


USER $DIRECT$ NOLOG 
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USER DIRECT (3391) 


MDISK AQ4 3390 001 002 XASRES R 
te 

USER $CP-NUC$ NOLOG 

MDISK AQ9 3390 003 010 XASRES R 
* : 
USER $SYSCKP$ NOLOG 

MDISK AQ6 3390 013 002 XASRES R 
* 

USER $SYSWRM$ NOLOG 

MDISK AQ7 3390 015 G02 XASRES R 
* 

USER $PAGE$ NOLOG 

MDISK AQ3 3390 017 023 XASRES R 
* 

USER $SPOOL$ NOLOG 

MDISK B01 3390 040 O82 XASRES R 
* 

USER $T-DISK$ NOLOG 

MDISK BO1 3390 406 019 XASRES R 


* 
KHAEKECKEAEKEEKKEURKEKEKEEERERERERRERERRREREEKREREREREKREREEREREREREEE 
* CMS USERIDS * 
HHAKKCKKEKKKKEKEKEEEREEREREREERERERERERRRREREREREKEEREKREKERERKES 
* 


USER CMS1 NOLOG 3M 32M G 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT4 CMSTST 

IPL CMS 

CONSOLE G09 3215 

SPOOL GOC 2540 READER A 
SPOOL GOD 2540 PUNCH A 
SPOOL 6OE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 


* 
HAH IAI IIRAKIII AAAI ANIKI IIASA IIIA AIA AIA ASIII AIS ISSA IAININ ISIN 
is PROP LOGICAL OPERATOR ud 
HI KIKI III IAIA IIIA IIIA IIA IIA SI ASIII ASI ASI AIA ASIII ASAIN AISI AAAI 
* 


USER LGLOPR NOLOG 512K 16M ABCDEG 
ACCOUNT ACT1 PROP 
IPL CMS 

CONSOLE 009 3215 

SPOOL GOC 2540 READER A 

SPOOL GOD 2540 PUNCH A 

SPOOL GOE 1403 A 

MDISK 191 3390 599 001 XASRES WR 
LINK MAINT 194 194 RR 

LINK MAINT 190 190 RR 

LINK OPERATOR 191 291 RR 


* 
HREAKKREKEEEERERKEEEEREREEREEREREREEEREREREERKREREEKEEEEEEEEEEEEREEERES 
* SYSTEM RELATED USERIDS * 
RAK AKHTAR RHE AKKEKERERERKEAEKAEKEREKEEKEEREKERERERKKEAEEERKKKE 
* 


USER MAINT NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 
IPL 190 
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USER DIRECT (3391) 


NAMESAVE GCS 

NAMESAVE VTAM 

NAMESAVE HELP 

NAMESAVE INSTHELP 
CONSOLE 809 3215 T 
SPOOL OO6C 2540 READER * 
SPOOL OGD 2540 PUNCH A 
SPOOL GOE 1403 A 


MDISK 123 3390 0060 2226 XASRES MW 
MDISK 124 3390 Q000 2226 XAPOO1 RR 
MDISK 125 3390 0000 2226 XASERV RR 


MDISK 190 3390 0488 068 XASRES 
MDISK 191 3390 0444 028 XASRES 
MDISK 193 3390 0277 043 XASRES 
MDISK 194 3390 0210 053 XASRES 
MDISK 5E5 3390 0594 005 XASRES 
MDISK 19D 3390 0320 038 XASRES 
MDISK 19E 3390 0364 042 XASRES 
MDISK 291 3390 0604 014 XASRES 
MDISK 292 3390 0618 019 XASRES 
MDISK 391 3390 0263 014 XASRES 
MDISK 392 3390 0708 019 XASRES 
MDISK 423 3390 0200 010 XASRES 
MDISK 490 3390 0132 068 XASRES 
MDISK 492 3390 0727 010 XASRES 
MDISK 49D 3390 0556 038 XASRES 
MDISK 593 3390 0747 085 XASRES 
MDISK 594 3390 0637 071 XASRES 
MDISK 692 3390 0737 010 XASRES 


MDISK 19C 3390 


1161 038 XASRES 


MW READ WRITE MULTIPLE 
MW 

MW READ WRITE MULTIPLE 
MW 

MW 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


WR 


MDISK 201 3390 0832 021 XASRES 
MDISK 293 3390 1237 132 XASRES 
MDISK 294 3390 1369 113 XASRES 


MW RMAINT WMAINT MMAINT 
MW RCMSAUX WCMSAUX MCMSAUX 
MW RCPAUX WCPAUX MCPAUX 


MDISK 295 3390 
MDISK 393 3390 


1482 013 XASRES 
1699 063 XASRES 


MDISK 394 3390 0908 123 XASRES 


MDISK 395 3390 
MDISK 491 3390 
MDISK 495 3390 
MDISK 49C 3390 
MDISK 501 3390 
MDISK 591 3390 
MDISK 592 3390 
MDISK 595 3390 
MDISK 596 3390 
MDISK 59E 3390 
MDISK 691 3390 
MDISK 791 3390 
MDISK 892 3390 
MDISK 895 3390 
MDISK 896 3390 
MDISK 89E 3390 


* 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36E 3390 0853 002 XASRES RR RPVM 


840 


1495 010 XASRES 
1031 008 XASRES 
1039 005 XASRES 
1199 038 XASRES 
1044 002 XASRES 
1505 090 XASRES 
1046 019 XASRES 
1065 012 XASRES 
1077 019 XASRES 
1096 012 XASRES 
1595 104 XASRES 
1108 012 XASRES 
1120 005 XASRES 
1137 012 XASRES 
1149 012 XASRES 
1125 @12 XASRES 
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MW READ WRITE MULTIPLE 
WR 

WR 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
WR 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
WR 

WR 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE - 


WPVM 


MPVM 


OOO ee ee SS Eee ee ee Te eS TT eh hhh ee eo eee ee 


LINK RSCS 191 499 MW 
* 


USER CMSBATCH NOLOG 1M 2M G 
ACCOUNT 3 SYSTEM 

OPTION ACCT 

IPL CMS PARM AUTOCR 
CONSOLE G09 3215 

SPOOL GOC 2540 READER * 
SPOOL 80D 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 


USER DIRECT (3391) 


MDISK 195 3390 602 002 XASRES MR RBATCH WBATCH MBATCH 


* 


USER GCS NOLOG 16M 16M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT GCS RECVM 
IPL GCS 
NAMESAVE GCS 
CONSOLE 009 3215 
SPOOL GOC 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL OGE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19D 19D RR 
LINK MAINT 595 595 
LINK MAINT 59E 59E 


MDISK 191 3390 358 004 XASRES MR RGCS WGCS MGCS 


* 


USER SYSMAINT NOLOG © 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 

IPL CMS 
CONSOLE 089 3215 T 
SPOOL GOC 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
LINK MAINT 123 123 MW 
LINK MAINT 191 192 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER OPERATOR NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 2 OPERATOR 
CONSOLE 009 3215 T 
SPOOL G@C 2540 READER * 

SPOOL GOD 2540 PUNCH A 

SPOOL GOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3390 122 605 XASRES MR 
LINK OP1 191 192 RR 


* 


*OP1 IS AN ALTERNATE OPERATOR USERID 
* 

USER OP1 NOLOG 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 3 OPERATOR 
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USER DIRECT (3391) 


IPL CMS 

CONSOLE 009 3215 

SPOOL OO0C 2540 READER * 

SPOOL 86D 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3390 129 001 XASRES MR 

LINK OPERATOR 191 192 RR 
* 
* This userid is for the IBM CE's use in running 
* OLTSEP. 
* OLTSEP is automatically IPLed in the virtual machine. 
* A minimum machine size of one megabyte is required to 
* run OLTSEP. 
* The privilege class of F allows the CE to specify 
* intensive recording mode. 
* The console address of O1F is required by OLTSEP. 
* The unit record addresses are those required by 
* OLTSEP. 
* The 5FF minidisk is the CE's OLTSEP pack. 
* 


USER OLTSEP NOLOG 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT OLTSEP IBMCE 
IPL 5FF 
CONSOLE O1F 3215 
SPOOL OOC 2540 READER A 
SPOOL GOD 2540 PUNCH A 
SPOOL GOE 1403 A 
MDISK 5FF 3390 000 2226 CEPACK MR 


=e SEREP-** ; 


+ ££ 


* This userid is for the IBM CE's use in running 
* CPEREP. 
* CMS is automatically IPLed in the virtual machine. 
* The 190 minidisk is the CMS system disk. 
* The 191 minidisk may be used to save often-used EREP 
* control statements and procedures (EXECs). 
* THE 190 MINIDISK HAS THE CMS TXTLIBS NECESSARY TO RUN 
* EREP. 
* 
USER EREP NOLOG 3M 8M BFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT EREP IBMCE 
IPL CMS 
CONSOLE O01F 3215 
SPOOL QOC 2540 READER A 
SPOOL GOD 2540 PUNCH B 
SPOOL GOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 201 201 RR 
MDISK 191 3390 127 G02 XASRES WR READ WRITE MULTIPLE 
* 
USER OPERATNS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 OPERATNS 
IPL CMS 
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USER DIRECT (3391) 


CONSOLE 009 3215 

SPOOL OOC 2540 READER D 

SPOOL OGD 2540 PUNCH A 

SPOOL O0E 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3390 472 016 XASRES MR RDVF WDVF MDVF 


* 
* 


USER AUTOLOG1 NOLOG 3M 8M ABCDEG 
AUTOLOG OP1 MAINT 
ACCOUNT 9 SYSTEM 

IPL CMS 
CONSOLE 009 3215 
SPOOL GOC 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL QOE 1403 A 
LINK MAINT 190 190 RR 
MDISK 191 3390 600 Q01 XASRES MR RAUTOLOG WAUTOLOG MAUTOLOG 

* 

USER DISKACNT NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 10 ACCNTNG 

IPL CMS 
CONSOLE 009 3215 
SPOOL GOC 2540 READER * 
SPOOL 60D 2540 PUNCH A 
SPOOL QOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3390 601 601 XASRES MR READ WRITE MULTIPLE 

* 

USER VMUTIL NOLOG 3M 8M BDEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 11 SYSTEM 

IPL CMS 

CONSOLE 009 3215 

SPOOL O0C 2540 READER * 
SPOOL QOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER SYSDUMP1 NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 12 SYSTEM 

IPL CMS 
CONSOLE G09 3215 
SPOOL OOC 2540 READER * 
SPOOL QOD 2540 PUNCH A 
SPOOL OO£ 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 123 3390 Q00 2226 XASRES RR 
MDISK 124 3390 000 2226 XAPOO1 RR 
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USER DIRECT (3391) 


MDISK 125 3390 G00 2226 XASERV RR 


* 
* 


USER RSCS NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 13 SYSTEM 

OPTION ACCT SVMSTAT LANG UCENG 

IUCV ANY 

NOPDATA 

* INCLUDE IF GCS NAMED SAVED SYSTEM IS RESTRICTED 
*NAMESAVE GCS | 

IPL GCS PARM AUTOLOG 

CONSOLE O01F 3215 T OPERATOR 

SPOOL @OC 2540 READER A 

SPOOL OGD 2540 PUNCH A 

SPOOL OOE 1403 E 

LINK MAINT 595 595 RR 

LINK MAINT 59F 191 RR 

LINK MAINT 190 190 RR 

LINK MAINT 193 193 RR 

LINK MAINT 19E 19E RR 

* Assigns real devices or communication lines at the specified 
* addresses to this virtual machine. 
*DEDICATE 740 740 

* 


USER PYM NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 14 SYSTEM 

IPL CMS 

CONSOLE 009 3215 

SPOOL GOC 2540 READER * 
SPOOL 06D 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK MAINT 36E 191 MR 


* 
* 
KEKEKREEEEKERERKRERKEEKRERREEEKEEEEKEEREEEREEREREREREEEERRKAKKEKEKE 
* OTHER OPERATING SYSTEM USERIDS * 
REREEREREEEEERERERERREREREEREREREEREREEEREEEREEERREREEREERERE RK 
* 
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XAMAINT Directory Entry (3391) 


Sample XAMAINT Directory Entry for a 3391 


If you are using the procedure in Chapter 4, “Installing VM/XA System Product Release 2.1 Using an 
Existing VM/SP or VM/SP HPO System” on page 215 to install your system, add the following entry to your 
directory: 

* 


USER XAMAINT NOLOG 16M 16M ABCDEFG 
OPTION ECMODE DIAG98 

ACCOUNT 1 SYSPROG 

IPL 190 

*NAMESAVE GCS 

*NAMESAVE VTAM 

*NAMESAVE HELP 

*NAMESAVE INSTHELP 

CONSOLE 009 3215 T 

SPOOL OOC: 2540 READER * 

SPOOL GOD 2540 PUNCH A 

SPOOL OOE 1403 A 

MDISK 123 3390 0000 2226 XASRES MW 
MDISK 124 3390 G000 2226 XAPOO1 RR 
MDISK 125 3390 @0G0 2226 XASERV RR 


MDISK 190 3390 0488 068 XASRES MW ALL 
MDISK 191 3390 0444 028 XASRES MW 
MDISK 193 3390 0277 @43 XASRES MW 
MDISK 194 3390 0210 053 XASRES MW 
MDISK 5E5 3390 0594 005 XASRES MW ALL 
MDISK 19D 3390 0320 038 XASRES MW ALL 
MDISK 19E 3390 0364 042 XASRES MW ALL 
MDISK 291 3390 0604 014 XASRES MW 


MDISK 292 3390 0618 019 XASRES 
MDISK 391 3390 0263 014 XASRES 
MDISK 392 3390 0708 019 XASRES 
MDISK 423 3390 0200 010 XASRES 
MDISK 490 3390 0132 068 XASRES 
MDISK 492 3390 0727 010 XASRES 
MDISK 49D 3390 0556 038 XASRES 
MDISK 593 3390 0747 085 XASRES 
MDISK 594 3390 0637 071 XASRES 
MDISK 692 3390 0737 010 XASRES 


MDISK 19C 3390 1161 038 XASRES 


MW READ WRITE MULTIPLE 
MW 

MW READ WRITE MULTIPLE 
Mi 

MW 

MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MDISK 201 3390 0832 021 XASRES MW RMAINT WMAINT MMAINT 
MDISK 293 3390 1237-132 XASRES MW RCMSAUX WCMSAUX MCMSAUX 


MDISK 295 3390 1482 013 XASRES 
MDISK 393 3390 1699 063 XASRES 
MDISK 394 3390 0908 123 XASRES 
MDISK 395 3390 1495 010 XASRES 
MDISK 491 3390 1031 608 XASRES 
MDISK 495 3390 1039 G05 XASRES 
MDISK 49C 3390 1199 038 XASRES 
MDISK 501 3390 1044 002 XASRES 
MDISK 591 3390 1505 090 XASRES 
MDISK 592 3390 1046 019 XASRES 
MDISK 595 3390 1065 012 XASRES 
MDISK 596 3390 1077 019 XASRES 
MDISK 59E 3390 1096 @12 XASRES 


~MDISK 294 3390 1369 113 XASRES MW RCPAUX WCPAUX MCPAUX 


MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
WR 
WR 
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XAMAINT Directory Entry (3391) 


MDISK 691 3390 1595 104 XASRES 
MDISK 791 3390 1108 012 XASRES 
MDISK 892 3390 1120 005 XASRES 
MDISK 895 3390 1137 012 XASRES 
MDISK 896 3390 1149 012 XASRES 
MDISK 89E 3390 1125 012 XASRES 


* 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MDISK 36E 3390 0853 GQ2 XASRES RR RPVM WPVM MPYM 


LINK RSCS 191 499 MW 
LINK MAINT 190 390 RR 
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XASRES Volume Allocation (3391) 


| System Residence DASD Allocation for a 3391 


| Figure 66 shows the allocation for the system residence device for the 3391 VM/XA SP Starter System. 


CYL CYL 

0060-0000 
0001-0002 
0003-0016 
0017-0039 


0040-0121 
0122 0405 
0406-0424 
0425-1113 


| Figure 66. System Residence DASD Allocation for a 3391 
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Minidisk Maps (3391) 


Minidisk Maps for a 3391 System Residence Device 


Figure 67 shows the minidisk maps of the system residence device for the 3391. To map your own system 
residence device for comparison, issue DISKMAP fn DIRECT, where f/m is the name of your directory. 


VOLUME USERID CUU DEVTYPE START END SIZE 
CEPACK OLTSEP 5FF 3390 0000 2225 2226 


VOLUME USERID CUU DEVTYPE START END SIZE 
XAPGO1 $ALLOC$ C01 3390 0600 0000 0001 
MAINT 124 3390 0000 2225 2226 **QVERLAP** 


SYSDUMP1 124 3390 0060 2225 2226 **OVERLAP** 


VOLUME USERID CUU DEVTYPE START END SIZE 
XASERV $ALLOC$ BOQ1 3390 0000 8000 @001 
MAINT 125 3390 0000 2225 2226 **OVERLAP** 


SYSDUMP1 125 3399 6000 #2225 = 2226 **OVERLAP** 


VOLUME USERID CUU DEVTYPE START END SIZE 
XASRES $ALLOC$ AQ1 3390 6060 6000 0601 
$DIRECT$  A0Q4 3390 6001 0802 0002 
$CP-NUC$ AOD 3390 6003 0012 0010 
$SYSCKP$ A06 3390 0013 0014 0002 
$SYSWRM$ AQT 3390 0015 6016 6002 
$PAGE$ AQ3 3390 0017 6039 0023 
$SPOOL$ BO1 3390 0040 0121 0082 
OPERATOR 191 3390 0122 0126 0605 


EREP 191 3390 0127 0128 0002 
OP1 191 3390 0129 0129 0001 
130 131 2 GAP 
MAINT 490 3390 0132 0199 6068 
MAINT 423 3390 0260 0209 0010 
MAINT 194 3390 0210 0262 0053 
MAINT 391 3390 0263 0276 0014 
MAINT 193 3390 0277 0319 0043 
MAINT 19D 3390 0320 0357 0038 
GCS 191 3390 0358 0361 6004 
362 363 2 GAP 
MAINT 19E 3390 0364 0405 0042 
$T-DISK$ B01 3390 0406 0424 0019 
425 443 19 GAP 


Figure 67 (Part 1 of 2). Minidisk Maps of the System Residence Device for a 3391 
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I nn nttne ee ae 


MAINT 
OPERATNS 


AUTOLOG1 
DISKACNT 
CMSBATCH 


SYSDUMP1 


395 
591 
691 
393 
123 
123 


3390 
3390 
3396 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 


3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 
3390 


0444 0471 
0472 0487 
0488 0555 
0556 0593 
0594 0598 
Q599 0599 
Q660 0600 
0601 0601 
0602 0603 
0604 0617 
0618 0636 
0637 0707 
0708 0726 
0727 0736 
0737 0746 
0747 0831 
0832 0852 
0853 0854 
855 907 
0908 1030 
1031 1038 
1039 1043 
1044 1045 
1046 1064 
1065 1076 
1077 1095 
1096 1107 
1108 1119 
1120 1124 
1125 1136 
1137 1148 
1149 1160 
1161 1198 
1199 1236 
1237 1368 
1369 1481 
1482 1494 
1495 1504 
1505 1594 
1595 1698 
1699 1761 
0600 2225 
Q000 2225 


8028 
6016 
6068 
6038 
6005 
6001 
6001 
0601 
0002 
0014 
0019 
0071 
0019 
0010 
0010 
6085 
G021 
0002 
53. GAP 

0123 
0008 
0005 
0002 
0019 
0012 
0019 
0012 
0012 
0005 
0012 
0012 
9012 
8038 
0038 
0132 
0113 
0013 
0010 
0090 
0104 
0063 
2226 **0VERLAP** 
2226 **QVERLAP** 


Figure 67 (Part 2 of 2). Minidisk Maps of the System Residence Device for a 3391 
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SPLOAD PROFILE 


Sample SPLOAD PROFILE 


Information about the product tape layout, fields for userid, minidisk address, format, volume number and 
tape number are contained in this profile. The following is an example of the SPLOAD profile for the 3420 
(6250 BPI) tape. 


! 6250 BPI VM/XA Merged Product Tape | 
| pawn nnn nn en nnn nnn nn nn nnn nnn en en nn nen enn nn ee ne oe =- ! 
! 

! Volume 1 

! 

Memo Files MAINT 191 XASP20V1 1 2 

Install Tools MAINT 191 XASP20V1 1 3 

Sysgen Tools MAINT 193 XASP20V1 1 4 

System Samples MAINT 191 XASP20V1 1 5 

CPLOC Samples MAINT 295 XASP20V1 #1 6 

CMSLOC Samples MAINT 395 XASP20QV1 1 7 

CP Object MAINT 194 XASP20V1 1 8 

CP Putapply MAINT 192 XASP20V1 1 9 

cP Putdelta MAINT 294 XASP20V1 1 10 

cP Corapply MAINT 291 XASP20V1 1 11 

cP Cordelta MAINT 291 XASP20V1 1 12 

DUMPVIEW Object MAINT 193 XASP20V1 1 13 

DUMPVIEW Putapply MAINT 392 XASP20V1 1 14 

DUMPVIEW Putdelta MAINT 293 XASP20V1 1 15 

DUMPVIEW Corapply MAINT 391 XASP20V1 1 16 

DUMPVIEW Cordelta MAINT 391 XASP20V1 1 17 

! 

! Volume 2 

! 

CMS Base MAINT 193 XASP20V2 2 2 

CMS Putapply MAINT 392 XASP20V2 2 3 

CMS Putdelta MAINT 293 XASP20V2 2 4 

CMS Corapply MAINT 391 XASP20V2 2 5 

CMS Cordelta MAINT 391 XASP20V2 2 6 

IOCP Files MAINT 193 XASP20V2 2 7 

CMS System MAINT 190 XASP20V2 2 8 

GCs Object MAINT 595 XASP20V2 2 9 

GCs Interface MAINT 193 XASP20V2 2 10 

GCS Putapply MAINT 592 XASP20V2 2 11 

GCS Putdelta MAINT 596 XASP20V2 2 12 

GCs Corapply MAINT 491 XASP20V2. 2 13 

GCS Cordeltta MAINT 491 XASP20V2 2 14 

AMENGHLP Files MAINT 19D XASP20V2 2 15 

UCENGHLP Files MAINT 19C XASP20V2 2 15 

! 

! Volume 3 

J 

cP Source MAINT 394 XASP20V3 3 2 

CMS Source MAINT 393 XASP20V3 3 3 

DUMPVIEW Source MAINT 393 XASP20V3 3 4 

! 

! 

/* a aa ac a a es * / 
‘ 6250 BPI VM/XA NLS Feature Tape */ 
OE case ces se eae Sea eee esc ee a cess eee me ee a et * 

CMS Base MAINT 193 R2MONLS 1 2 


850 Installation and Service 


ee oe eee eee 


Object 
Files 

Source 
Object 
Object 


MAINT 
MAINT 
MAINT 
MAINT 
MAINT 


SPLOAD PROFILE 


R2MONLS 1 3 
R2MONLS 1 4 
R2MONLS 1 5 
R2MONLS 1 6 
R2MONLS 1 / 


* 
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Appendix D. Listing CP Data Areas and Control Blocks 


You can obtain a listing of CP data areas and control blocks written in ASSEMBLER by assembling a file 
called HCPBLOKS ASSEMBLE. (Data areas and control blocks in PLAS are not listed). Follow these 
steps: 


1. Establish the appropriate minidisk access order: 


vmfsetup 56643089 cp Hf 


2. Copy and unpack the HCPBLOKS ASSEMBLE file. You must do this because the UPDATE module 
requires unpacked files. HCPBLOKS ASSEMBLE is on the CP BASE2 disk (394) in packed format. 


copy hcpbloks assemble fm = = a (unpack olddate @ 


3. If you have updates to HCPBLOKS ASSEMBLE, use the UPDATE command to apply the updates to 
the source file: 


update hcpbloks assemble * hcpxa cntr] * (ctl Mf If there are no update files, you will receive the 
message NO UPDATE FILES WERE FOUND. 


4, Issue the GLOBAL command for the macro libraries listed in HCPXA CNTRL: 


global maclib cpnew hcpgpi hcppsi hcpoml hcpom2 cplib dmsgpi dmsom osmacro 


5. Set the virtual punch to remain open after spool files reach 50,000 records: 


spool punch noeof @ 


6. Assemble HCPBLOKS with HASM. With the options shown below, HASM will generate a PRT file 
that contains the assembler listing of HCPBLOKS. This listing includes the CP data areas and control 
blocks. 


hasm fn (sysparm (exp) xref (full) print jn is $HCPBLOK if updates were applied. 
Otherwise, it is HCPBLOKS. 


PRT FILE spoolid SENT FROM MAINT PRT AS spoolid RECS nnnn COPY 001 A NOHOLD NOKEEP 


7. You can now erase the work files on your A disk: 


erase hcpbloks assemble a @& 
erase hcpbloks text a Mf 
erase $hcpblok assemble a @ 
erase $hcpblok text a @ 
erase hcpbloks updates a 
erase hcpbloks updlog a @ 
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Appendix E. Example of Alternate GCS Nucleus Placement 


Overview 


This appendix demonstrates how to save your GCS system at a virtual storage location other than the one 
provided by the product tape samples. You might want the GCS segment at a different location, depending 
on the other segments being used by your GCS group. 


This section also describes how to increase the size of the GCS saved system. One reason that you might 
want to do this is to increase the amount of available common storage. Refer to VM/XA SP Planning and 
Administration for information about calculating common storage requirements for GCS. 


To relocate your GCS saved system and change its size, you need to: 


Change the SLC names in the GCSLOAD EXEC 

Create SLC files to contain the new address locations 

Modify the DEFSYS entries in the SAMPNSS EXEC for GCS 
Build and save the GCS nucleus. 
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Procedure 


This sample procedure demonstrates how to relocate your GCS saved system in a 16-megabyte virtual 
machine. Originally 2M in size and loaded at X'400000', the segment is moved to X'800000' and increased 
in size to 3MB. 


1. Log on as MAINT and access the GCS system disk: 


access 595 a @& 


2. Modify the GCS loadlist (GCSLOAD EXEC A) and change the Set Location Counter (SLC) values that 
determine where the shared portion of GCS is loaded into virtual storage. 


In the commands that follow, “SLC L400000” is the name of a CMS file that contains the address of the 
starting location for loading the main portion of the GCS nucleus. This SLC statement precedes the 
CSIALP entry in the loadlist. “SLC L600000” marks the end of the GCS nucleus (also the end of 
common storage), and it precedes the CSIZET entry. 


Note: The GCS loadlist may be changed by service. After applying a PUT, you should check the file 
and change it if necessary before you rebuild the GCS nucleus. 


Enter the following commands: 


xedit gcsload EXEC a @ 

set case upper & 

top @ 

change / SLC L460000 / SLC L800000 /* @& 
top 

change / SLC L60G000 / SLC LBO0000 /* 
file 


3. Create two new SLC files to match the new loadilist: 


xedit SLC L800000 a @ 


input $SLC 8@0000 MI There must be two blanks between SLC and the 

set hex on # address. 

change /$/X'02'/ @ X'02' is an unprintable loader control character. 

file 

xedit SLC LB00000 a 

input $SLC B00000 There must be two blanks between SLC and the 
address. 

set hex on Mf X'Q2' is an unprintable loader control character. 

change /$/X'02'/ @f 

file @ 
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4. Modify the DEFSYS entry for your GCS saved system in the SAMPNSS EXEC. As a result, you may 
also have to change other DEFSYS entries. In this example, the new location for GCS overlays the 
default locations for CMSVSAM and CMSAMS, so you will have to change those entries. 


Note: To convert an entry in the system name table of a VM/SP or VM/SP HPO system to a DEFSYS 
entry, see VM/XA SP Conversion Notebook. 


The IBM-supplied DEFSYS entry for GCS in the SAMPNSS EXEC looks like this: 
'CP DEFSYS GCS 0-6 EW 400-5FF SW MINSIZE=256K VMGROUP RSTD' 
GCS occupies pages 400 —5FF (all of segments 4 and 5). 

a. Calculate the new values for the DEFSYS entry: 


1) To calculate the page number where the GCS nucleus begins, divide the corresponding SLC 
value (X'800000' in this example) by the page size, X'1000'. The result is X'800'. 


2) To calculate the page number where GCS ends, divide the corresponding SLC value (X'B00000' 
in this example) by X'1000' and subtract one. The result is X'AFF'. 


b. XEDIT the SAMPNSS EXEC and enter the new values in the DEFSYS entry for GCS. The 
changed entry looks like this: 


‘CP DEFSYS GCS 0-6 EW 800-AFF SW MINSIZE=256K VMGROUP RSTD' 


5. Copy the latest version of the product parameter file to the 191 minidisk: 


copy 56643089 $ppf fm = = a (replace Bt 


6. Generate and save the GCS nucleus: 


access 495 c You do not want to change the nucleus on the 595 
disk. 


7. Before you generate the nucleus, you may want to use GROUP EXEC to create a new GCS 
configuration file for this nucleus. See the GCS step in the installation procedure. 


itask build gcs systemname @& If you do not specify a systemname, the default is 
ip] cms GCS. 
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Appendix F. Restricted Logon Passwords 


The CP nucleus includes a system security feature called ADRP (Auto-Deactivation of Restricted Passwords). 
ADRP works with a CMS file named RPWLIST DATA that contains the list of restricted logon passwords 
shown in Figure 68. You can edit this file to add your own restricted passwords. 


Issuing the DIRECTXA command causes the system to search the directory for the restricted passwords 
contained in this list. All passwords that match are changed to NOLOG in the directory before the directory 
is placed online. You cannot log on to any user ID whose password has been changed to NOLOG. 
Therefore, make sure that you have changed all restricted passwords in the directory to unique non-restricted 
passwords before you issue the DIRECTXA command. 


ACNT AARKEKEKEERKEREEEERERERUKEREREERERERERERRERREREREERERERRERREEREEEE 


AUTOLOG * THIS MODULE IS RESTRICTED MATERIALS OF IBM. i 
AUTOLOG] * 5664-308 (C) COPYRIGHT IBM CORPORATION - 1988 . 
BATCH  * LICENSED MATERIALS - PROPERTY OF IBM i 
CE * SEE COPYRIGHT INSTRUCTIONS, G120-2083 " 


CMSUSER HRERARKKRRERAEEEREEEREEREREREREREREEEREREEREREEREREREREERERRREEEES 


CMS1 


CMS2 REKEKKEEREREEERERERRRKEEEREREREKREREERREEREEEREREREEEEEERRERERESE 


Restricted Password List 
Format Rules: 


1) The RPWLIST DATA file must be fixed record length 
format, with a record length of at least 8. 

2) Each password must start in column 1. 

3) Columns 1-8 must contain restricted passwords only. 

4) Each line may contain only one password. 

5) Column 9 must contain a blank. 

6) Columns 10 through 80 may be used for comments, such 
as this prologue. 


ISMAINT 
ITPS 
IVPASS 
LEV2VM 
MAINT 
MASTER . 
MDVR SRK III IK IIIT IAI IRIS AIRS II ASTI ISN AIA IMIS ANSI SA IAAI AAIAIITIAISNI 
OPASS 

OPERATNS 

OPERATOR 

OSVS1 

PASSWORD 

PRODBM 

PROMAIL 

PSR 

ROUTER 

RSCS 

SFBATCH 

SSFCAL 

SQLDBAPW 

SQLUSER 

SYSADMIN 

SYSDUMP 


td 

"O 

© 

” 
+ £€¢ t+ *+ © + + * + + HF HF F 
+ + € + + &€ & He + & HF & 


VSEIPO 
VSEMAINT 


Figure 68. The RPWLIST DATA File 
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Appendix G. Controlling Disk String Merges 


Automatic Merging 


VMFREC normally merges minidisks in accordance with the :MERGE. tag in the product parameter file. 


Since disks are merged only within a string (for example, DELTA disks are merged to DELTA disks, not to 
APPLY disks), merging does not consolidate the contents of all disks, but saves back levels of service on the 
current disks and frees the alternate disks for new levels of service. 


Preventing Automatic Merging 


You may not want VMFREC to merge certain disk strings. A common reason for suppressing the merge is 
to receive multiple COR tapes on the alternate DELTA and APPLY disks so that a single APPLY step can 
be performed. In the more general case, you may wish to group the contents of service tapes differently than 
would result from using the default :\MERGE. tags. Always merge the APPLY and DELTA strings the same 
way because they work in pairs. 


To prevent VMFREC from merging, choose one of the following methods: 


¢ Remove the symbolic disk string names from the :MERGE. tag in the PPF. Do not remove the merge 
tag itself because it is a required tag. 


¢ Define and format an additional minidisk and put it at the head of the string that you do not want to 
merge. VMFREC will not merge if the top disk is empty. The method will require you to include the 
new top disk as the leftmost disk in the string in the :MDA. section of the PPF. 


Remember to make changes to the PPF with overrides. Also remember that if you are processing COR 
service, you must have an additional COR override. Below is an example of an override file called 
NOMERG $PPF that will suppress all merging for the CMS component. 


sOVERLIST. CMS CORCMS 


* 

sCMS. CMS 56643089 
:MERGE. 
sEND. 


* 


:CORCMS. CMS 56643089 
:MERGE. 
sEND. 


Manual Merging 


Merging One Disk to Another 


To merge a disk to another disk, you must first copy the entire contents of the origin disk to the destination 
disk and then erase the entire contents of the origin disk. 


The filemode number must be included on the COPYFILE commands because if a file of the same filename 
and filetype exists on the destination disk with a different filemode number, the filemode number of the 
destination disk is retained. Since the filemode numbers are used to indicate the applied status of update files 
and $PTFPART lists, it is very important to retain the filemode number from the origin disk. 
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After all of the files on the origin disk are merged (that is, copied) to the destination disk, use the erase 
option of the access command to clear the disk. You must then create a dummy file on the origin disk in 
order to commit the erase: 


access origin_addr origin_fm @l 
access destination_addr destination fm Ei 


copy * * origin_fm0 = = destination _fmO0 (olddate replace @ 
copy * * origin_fm6 = = destination _fm6 (olddate replace @ 


access origin_addr origin_jm (erase Wl 
xedit dummy file origin fm @ 

input dumny @ 

file Hf 
erase dummy file origin _fm @ 


Merging an Entire Disk String 


To merge a disk string that contains 3 layers (production, intermediate, alternate), you must use the above 
procedures to merge the intermediate to the production and then merge the alternate to the intermediate. 
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Appendix H. Service Reference Tables 


VM/XA SP Filetypes and Abbreviations 


The first column of Table 22 shows the 3-character abbreviations conventionally used for the filenames in the 
second column. These abbreviations are used in the filetype of parts supplied for service (see “Parts Supplied 


for Service and What to Do with Them” on page 865). 


Table 22 (Page 1 of 2). VM/XA SP Filetypes and 


* e 


Abbreviations 


Abbreviated Filetype Complete Filetype 


SCONSTS 


$C 

$E 

$P $PPF 
$X 

A 


$XEDIT 


NUXMXA 


N 
», « 
F 
E 
M 
N CONSTS 
Y 
L 
T 
LB 


S 
CNTR 

D DOSLIB 
DLK DOSLNK 
DIRECT 
DSF 
EXCAMENG 
EXCUCENG 


AM 


eg. 


ABBE 
5/2 /3/2 


XC 
EXECLIST 
HELPABBR 
HELPCMS 
HELPCP 
HELPCPQU 
HELPCPSE 
HELPDEFI 
HELPDISP 
HELPDUMP 
HELPEDIT 


ot | i 
Al. 


HCM 
HCP 

C 
C 


sm 
~Q 


am 
7) 


HDU 


© Copyright IBM Corp. 1990 


Table 22 (Page 1 of 2). VM/XA SP Filetypes and 
Abbreviations 


Abbreviated Filetype 


Complete Filetype 
HELP 
HELPEXEC 
HELPEXC2 
HELPGROU 
HELPHELP 
HELPINDI 
HLP 
HELPMACR 
HELPMENU 
HELPMONI 
HELPCMSQ 
HELPMSG 
HPF HELPPF 
HELPPREF 
HELPPURG 
HELPQUER 
HELPREXX 
HELPSET 


Task ~*d CELT 
russ —~+dsSELPCMsS 
ce ~*dCE PED 
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ae 
a 


E 


G 


rr 
Z 


a 
7a 


se 
= 
y 


HMA 


HPU 


~ 
Cc 


Table 22 (Page 2 of 2). VM/XA SP Filetypes and 
Abbreviations 
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Parts Supplied for Service and What to Do with Them 


Table 23 shows the parts that IBM will supply for service to each part of your system. The first column 
identifies the part to be serviced by filetype. The second column shows whether that kind of part is serviced 
by update, replacement, or both. The third and fourth columns list the parts that IBM will send you when 
you apply COR service and PUT service, respectively. The fifth column shows the parts required for update 
service: the source file (for example, an ASSEMBLE file), which you already have, the update, which is 
supplied on the COR or PUT tape, and the auxiliary control file, which is generated during the service 
process. The sixth column shows the most important EXECs and commands you will use in rebuilding the 
serviced part. (For full instructions, see Chapter 14, “Rebuilding CMS after Applying Service” on page 431, 
Chapter 15, “Rebuilding CP after Applying Service” on page 487, Chapter 16, “Service to DV” on 

page 507, or Chapter 17, “Service to GCS” on page 517.) If the sixth column is blank, the part supplied by 
IBM simply replaces the one you already have. If you want to keep your own part for reference, you can 
rename it. 


Table 23 (Page 1 of 2). Parts Supplied for Service and What to Do with Them 


| Update or Parts for Parts for 
Usable Form Replace? COR Service PUT Service Update Parts Build Function 


Update Update EXECUPDT 
AUXXA AUXXA 

EXCnnnnn EXCnnnnn Copy fn 
EXEC EXEC EXCnnnnn fm 
$EXnnnnn' $EXnnnnn' = EXEC =? 
$EXEC! $SEXEC! 


EXCnnnnn EXCnnnnn Copy jn 
EXCnnnnn fm 
= EXEC = 


EXECUPDT 


Copy fn 
XEDnnnnn fm 


$XEnnnnn! $XEnnann' = XEDIT 
$XEDIT! $XEDIT! =? 


Replace Copy fn 
XEDIT XEDnannnn fm 
= XEDIT = 
MACLIB Update 
MACRO 
1 
Replace MACLIB 
MACLIB 


COPY Update 
COPY 
CPYnnnnn' CPYnnnnn' 
COPY! COPY! 
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Table 23 (Page 2 of 2). Parts Supplied for Service and What to Do with Them 


Update or Parts for Parts for 
Usable Form Replace? COR Service PUT Service Update Parts Build Function 


MODULE Update Update Update Update CMSGEND 
ASSEMBLE TXTxrnnann TXTnnnnn AUXXxXxXxx UTILITY 
ASMannnn!' ASMannnn' ASSEMBLE GENMOD 
ASSEMBLE! ASSEMBLE! — 
MODULE? 
Replace text TXTnnnnn TXTnannn Copy fn 
deck MODULE TXTnnnnn fm 
Replace MODan»annnn MODnnnnn 
MODULE MODULE MODULE 


VMFBLD 
HCPLDR 


Update 
ASSEMBLE 


Update Update 
TXTnnnnn TXTnnnnn 
ASMannnn} ASMnnnnn} 
ASSEMBLE! ASSEMBLE? 


NUCLEUS 
Replace text TXTnnnnn TXTnnnnn VMFBLD 
HCPLDR 


TEXT 


$PPF Replace $PPF | $PFannnn $PFnnnnn 
$PPF $PPF 

Other parts Replace part aaannnnn aaannnnn 
real filetype real filetype 


nnnnn The number of the most recently applied PTF. 


Update 
AUXXxxxx 
ASSEMBLE | 


Update Update Update Update VMFHASM 
ASSEMBLE TXTnnnnn TXTxrnann AUXxxxxx 
ASMnannn' ASMnrnnnn! ASSEMBLE Copy fn 
ASSEMBLE’ ASSEMBLE? TXTnnnnn fm 


Replace text 


deck TXTnnnnn fm 


$PFunnnn fm 


aaannnnn ft 


XXXXX Is 1- to 5-alphanumeric characters. 
aaa The text deck filetype prefix from the AUX file identification record in the main control file. 
Notes: 


1 This is a base part. This part is shipped from IBM only when it is a new part or when the part 
(source) is replaced. . 


? This procedure is used when there are no local modifications. 
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Appendix I. How to Find the PTF Number from the APAR 


Number 


If you know the APAR number associated with an update, you can find the corresponding PTF number. 
For example, suppose that you want to find the PTF number for APAR 01010. 


1. Find the filename of a module affected by the APAR. (If you are looking for the PTF number 
associated with an update listed in a DEPEND entry, you already know one.) 


listfile * *01010* * 
HCPABC AQ1010HP fm 


2. List all text decks with the filename of that module: 


listfile hcpabc txt* * (EXEC 


The EXEC option saves the list in a file called 
CMS EXEC. Any previously existing CMS 
EXEC on your A-disk 1s erased. 


3. Look at each text deck until you find one that lists the APAR you are looking for: 


xedit hcpabc txtnnnnn 
locate /01010 @ 


AQ1Q10HP COR UMQO000 * Comments 
* PREREQ: NONE 

* CO-REQ: NONE 

* IF-REQ: NONE 

A34567HP COR UMOO001 * Comments 
* PREREQ: NONE 

* CO-REQ: NONE 

* IF-REQ: NONE 

A56789HP COR UMOQ002 * Comments 
* PREREQ: NONE 

* CO-REQ: NONE 

* TF-REQ: NONE 

* DEPEND: AOQ1010HP 

A88888HP COR UMOQ0003 * Comments 


(Executable text is here.) 
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The APAR number is the 5 numeric characters in 
the first word of the text deck line. The 
corresponding PTF number is the third word of 
the same line. 
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Appendix J. Messages 


This appendix contains messages issued by the 
service EXECs. For other messages, see the 
VM/XA SP System Messages and Codes Reference. 


002E [Input|Overlay] {File[(s)] 
|Dataset|Note} [fn [/t [fn|dirname ]]] 
not found 


Explanation: The specified file was not found on 
the accessed disks. Either the file does not reside 
on this filemode, the file identification was 
misspelled, or incomplete identification was 
provided to cause the appropriate filemode to be 
searched, or system disk was not accessed as a 
read-only extension of filemode A. 


For the PRELOAD command, either the 
loadlist EXEC, the CNTRL file, or one of the 
input text files could not be found. 


For SETPRT command, the module 
represented by fn ft does not exist in the current 
CMS search order. 


For the STATEW command, the file may exist, 
but it is not on any of the user’s read/write 
filemodes. 


For the ZAP command, either none of the 
libraries specified for a TXTLIB or LOADLIB 
could be found, or the INPUT filename could 
not be located via the STATE macro. 


For the ZAPTEXT and EXPAND commands, 
the input text file or INPUT filename could not 
be located via the ESTATE command. 


For the VMFLKED command, either you 
specified a file that cannot be found on a 
filemode in the CMS search hierarchy, or you 
specified a filename on a % CONTROL 
statement as the name of a CNTRL file and 
that file was not found. 


For the VMFPLCD EXEC, the specified file 
was not found. If the specified file is the 
envelope file it must exist for any functions 
except DUMP, WGS, or RST. If the file ID is 
not the envelope file, then it was a file specified 
on a SCAN or SKIP file which could not be 
found within the constraints of the option EOG 
or EOD limit. 


For the CONVERT command, the input DLCS 
file you specified was not found. 
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See the CMS Command Reference for a description 
of the file identification required by each command 
and the search procedure used. 


System Action: RC =20/28/36. 
Execution of the command is terminated. The 
system status remains the same. 


For DMSSPR, nothing has been sent to the virtual 
3800. 


For DMSLIO, some loader information fields have 
been initialized, but they should not interfere with a 
subsequent LOAD command. 


For the CONVERT command, conversion stops. 
RC = 44, 


For the VMFPLC2 command, the STOP option 
has been specified with the LOAD function, and the 
file was not found in alphabetic sequence. The tape 
is positioned immediately before the next file. 


For VMFPLCD, if RC=20, the envelope file ID is 
not 2 valid CMS file ID. If RC=36, the disk was 
not accessed at all, or not accessed in R/W mode. 
For the VMFLKED and VMFZAP commands, 
processing ends. 


For the VMFMERGE command, other required 


_ files are checked and then processing ends. 


User Response: Find or create the desired file. To 
make sure the file exists, issue LISTFILE fn ft * or 
STATE fn ft *. Correct and reissue the command. 


For DMSSPR, access the disk having the required 
module or respecify a different module in the 
calling sequence and then reissue the SETPRT 
command. 


For a DMSROS TEXT file, ensure that the file is 
accessible and reissue the command. 


For the VMFLKED command, make certain that 
the proper disks are accessed and check the name of 
the specified file. If the name was specified 
incorrectly, reissue the command with the correct 
name. For VMFPLCD, correct the file ID, 
reposition the envelope file if necessary and reenter 
the command. 


For VMFTXT: 


If the filetype is EXEC, make sure that a 
memberlist EXEC file exists and that the filename 
of the memberlist and the libname parameter are 
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spelled the same. Correct the error and reissue the 
command. 


If the filetype is CNTRL, make sure that the 
specified CNTRL file exists and is correctly spelled. 
Correct the error and reissue the command. 


If the filename and filetype pair is one of the 
following: 


VMFMSGS EXEC 
VMFDATE MODULE 
VMFIXT DATA 


contact your system programmer and arrange to 
have these files installed again on the CMS system 
disk as filemode 2 files. 


For the VMFZAP, VMFMERGE, and 
VMFREMOV commands, see if the proper disks 
are specified in the VMFPARM file and then 
re-issue the command. 


For the CONVERT command, correct the filename 
or access a disk or directory where the file can be 
found. 


003E Invalid option option. 


Explanation: The specified option is invalid. It 
may have been misspelled, or, if the option is 
truncatable, it may have been truncated improperly, 
or it may conflict with another option in the 
command line. 


System Action: RC=8. 


Execution of the command is terminated. The 
system status remains the same. 


For DMSLIO, some option processing may have 
caused such things to happen as user storage to be 
cleared or the location counter to be set. This 
should not interfere with a subsequent LOAD 
command. 


For the VMFLKED command, processing ends. 
User Response: Correct and reenter the command. 
010S Premature end occurred on fn ft fm 


Explanation: The physical limits (forward or 
backward) of the envelope file were exceeded or a 
command completed before the group count 
specified by option EOG was satisfied. 


System Action: Processing is terminated. RC=40. 


User Response: Use positioning commands to reset 
the position within the envelope and reenter the 
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command. Use an EOG count (or option EOD) to 
limit the command if necessary. 


040E No file loaded [for fn ft] 


Explanation: The user has not previously issued a 
LOADMOD or LOAD command, or the module 
consists of zeros. 


System Action: Execution of the command is 
terminated. The system status remains the same. 
The position of the envelope file Gf any) depends 
on the limits specified by option EOG or EOD. 
RC=40. 


User Response: Load files via the LOAD or 
LOADMOD command. If using envelope files, 
reposition the envelope file and reenter the 
command with a different file ID to be loaded. 


048E Invalid {filemode|output filemode} 


[mode] 


Explanation: This message can occur for any one 
of the following reasons: 


¢ The filemode was not specified correctly. 


¢ For most CMS commands, filemode ‘S’ is an 
invalid mode. 


e For the DLBL command, filemode ‘R’ and “T’ 
should not be used. 


¢ The filemode number, if specified, is not 
between 0 and 6. 


¢ More than 2 characters were specified for the 
filemode. 


e A null line was entered as the first specification 
with the MULT option of the DLBL 
command. 


e The filemode specified with a LISTDS 
command was not the mode of an OS or DOS 
disk. 


e The filemode specified with a LISTFILE 
command was not the mode of a 
CMS-formatted disk. 


¢ For XEDIT, if a filemode number is not 
specified, a 1 may be appended to the invalid 
filemode. 


¢ For VMFPLCD, the filemode specified on a. 
VMFPLCD LOAD command to which the files 
are to be loaded is either invalid or was 
specified as ‘*’. 


System Action: Execution of the command is 
terminated. The system status remains the same. 
The position in an existing envelope, if any, is not 
affected. RC =24. 

For DMSTPI or VMFPLC72, if the DEN, 
STRACK, or 18TRACK options were specified, the 


modeset byte has been set for the specified device 
(TAPi, where i = 1, 2, 3, 4) or TAP. 


User Response: Reissue the command with the 
filemode specified correctly. 


0S50E Parameter missing after value. 


Explanation: A parameter that is required by the 
command was not specified. 


For the ASSGN command, the disk mode must be 
specified for the SYSaaa logical unit. 


For the DLBL command, the disk mode or 
DUMMY or CLEAR must be specified after the 
ddname. 


For the FILEDEF command, the device name or 
DUMMY or CLEAR must be specified after the 
ddname. 


For the NUCXDROP command, a required 
parameter that must follow a function is missing. 


For the SET command, a required parameter that 
must follow a function is missing. 


For the XMITMSG command, one of the options 
required a value to follow it, but the end of the 
parameter list was reached. 


System Action: RC=8. 


Execution of the command is terminated. The 
system status remains the same. 


User Response: Correct and reissue the command. 


056E File filename filetype filemode contains 
invalid record format. 


Explanation: For DMSLBM and DMSNCP 
(GEN, ADD, REP), the specified file is not in the 
expected format. MACRO and MEND cards must 
be included in the MACRO files, and the prototype 
card must be specified with a name that does not 
exceed 8 characters. If an &COPY statement 
appears, it must contain a name. A MACLIB must 
contain “LIB” in columns 4—6 of record one. 


For DMSLBT, the specified file has more than 255 
entry points (ESD only), or has records which are 


incompatible or missing. The NAME field in the 
CSECT instruction of the specified file must have a 
valid symbol or label. 


For DMSLIO, an invalid condition was found in a 
TEXT or TEXTLIB file. TXTLIB files created on 
EDF disks must have “PDS” in columns 4-6 of 
record one. TXTLIB files created on non-EDF 
disks must have “LIB” in columns 4—6 of record 
one. RLD data must be compatible with the TEXT 
file or TXTLIB member to which is belongs. If an 
ICS statement was submitted, the specified name 
was previously defined, or the initial length of the 
CSECT was not found in the ESD card. 


For DMSSYN, the specified file is not in the 
expected format. The SYNONYM file must 
contain 80-byte records in free form format, with 
columns 73 — 80 ignored. The data consists of a 
command name followed by a blank and the user 
synonym. This may optionally be followed by a 
count which is preceded by at least one blank. 


For DMSZAP, either the header record for 
TXTLIB or LOADLIB was invalid, or the pointer 
to the directory or module map was in error. 


For the VMFTXT command, the memberlist 
EXEC file was not in the required format. 


System Action: RC = 100. 

Execution of the command Is terminated. The 
system status remains the same. For DMSGLB, 
the library is not globally searched, and the 
operation continues for any other libraries named in 
the command. 


For the VMFTXT command, the invalid record is 
ignored. Processing continues for any remaining 
records in the file. 


User Response: For DMSLBM and DMSNCP, 
issue the MACLIB COMP command, then check 
the MACLIB with a MACLIB MAP command. 
Correct the format error. 


For DMSGLB, the specified library does not have 
“LIB” in columns | —3 or 4—6 of the first record. 
One possible cause is the library may be in packed 
format. Correct the library and reissue the 
command. 


For DMSSYN, correct the format of the file. 
For DMSLIO, recreate the TXTLIB or TEXT file. 


For DMSLBT, if the message specifies ESD, check 
for more than 255 entry points for a member; 
otherwise, check for invalid or missing records. If 
the NAME field in the CSECT instruction was left 
blank, enter a valid symbol or label. 
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For the VMFTXT command, correct the invalid 
entry in the memberlist EXEC file. If the member 
specified in the invalid record has a filetype of 
TEXT, you may issue the: 


TXTLIB VMFTXT ADD membername 
<(FIlLename<)>> 

RENAME VMFTXT TXTLIB A libname 
TXTLIB A 


commands. If the filetype is not TEXT, then erase 
VMFTXT TXTLIB A and then reissue the 
command. 


For DMSZAP, recreate the library or module. 


Then reissue the command. 


062E Invalid character char in filename filetype 


filemode. 


Explanation: The character specified was invalid in 


the file ID in which it appeared. 
System Action: _RC=100. 


Execution of the command is terminated. The 
system status remains the same. 


User Response: Reissue the command, specifying 
the correct file ID. 


065E option parameter specified more than 
once. 


Explanation: The option was specified more than 
once in the command line. 


System Action: _RC= 100. 


Execution of the command is terminated. The 
system status remains the same. 


User Response: Reissue the command, specifying 
the option only once. 


066E The variations of this message are 
explained below. 


¢ option! and option2 are conflicting options 


Explanation: The specified options are 


mutually exclusive and must not be in the same 


command. 


System Action: Execution of the command 1s 
terminated. The system status remains the 
same. RC=24. 


User Response: Correct and reissue the 
command. 
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© optionl, option2, option3, option4, option) are 
conflicting options 
Explanation: The identified options are 


mutually exclusive and must not be specified in 
the same command. 


System Action: Processing is terminated. The 
position in an existing envelope, if any, is not 
affected. RC=24. 


User Response: Reenter the command with 
only one of the options. 


1048 Error nn reading file fn ft fm [from 
{disk|XEDIT}] [RC=rc from command] 


Explanation: An irrecoverable error occurred while 
reading the file from disk. nm indicates the nature 
of the error; it may be one of the following: 


Code Meaning 
l The specified file was not found. 


2 The buffer area is not within user storage 
limits. 
3 A permanent disk read error occurred. This 


may occur if you link to and access another 
user’s disk, and try to read a file that was 
refiled by its owner after you issued the 
ACCESS command. Reissue the ACCESS 
command and try to read the file again. 


5 The number of records is less than zero or 
more than 32,768. 


7 The fixed/variable flag in the file status table 
entry is not F or V. 


8 The given storage area was smaller than the 
actual size of the records read. (This error is 
valid if reading the first portion of a large 
record into a small buffer. It does not cause 
the function to terminate.) 


9 The file is open for writing and must be 
closed before it can be read. 


1] Only one record can be read for a 
variable-length file. In this case, the number 
of records is greater than 1. 


12 An unexpected end of file occurred (the 
record number specified exceeds the number 
of records in the file). 


13 A variable-length file has an incorrect 
displacement in the active file table. 


14 An invalid character was detected in the 
filename. 


15 An invalid character was detected in the 
filetype. 


19 An I/O error occurred on a FBA device. 
This was indicated by a non-zero condition 
code from a DIAGNOSE code X'20'. 
Error detected in a module DMSDIO. 


25 Insufficient virtual storage is available. 


26 Requested item number is negative, or item 
number plus number of items exceeds file 
system capacity. 

27 An attempt was made to update a 


variable-length item with one of a different 
length. 


System Action: Execution halts. The system 
remains in the same status as before the command 
was entered. 


For DMSEDI, the edit session is terminated. If the 
error occurred during a RENUM operation, the 
workfile is erased and the file being edited remains 
unchanged. 


For DMSEXL, the file specified in the 
EXECLOAD command was not loaded into 
storage. The execution of the command is 
terminated. 


For DMSDSL, the condition of the DOSLIB file is 
unpredictable. 


For DMSGLO, no global variable table(s) were 
created. 


For DMSLBM, the condition of the MACLIB file 
is upredictable. 


For DMSGLB, that library is not globaled, but the 
operation continues for any other libraries named in 
the command. 


For DMSXGT, if the error occurred during a GET 
operation, the subcommand is terminated and the 
editing session continues. 


For DMSXIN, the execution of the command or 
subcommand is terminated. If multiple files were 


being edited, the editing session continues for those 
files. 


For DMSXRE, if the error occurred during a 
RENUM operation, the subcommand is terminated 
and the editing session continues. 


For the TAPE command, if the DEN, TRTCH, 
7TTRACK, 9TRACK, or 18TRACK options were 
specified, the modeset byte has been set for the 
specified device (TAPn, where n is a character from 
0 to 9 or A to F; the default is TAP1). Some 
records may have been written on tape. RC=100 
or RC= Inn (an described above). 


User Response: If you can determine the problem 
from the “Explanation” and remedy the condition, 
reissue the command. If not, retry the command, 
and if the problem persists, call your system 
support personnel. 


For DMSDGL, verify DOSLIB integrity with the 
DOSLIB MAP command. 


For DMSGLB, RDBUF has returned an RC other 
than 0, 1, or 8. RC=1 indicates it is an OS/DOS 
DISK and RC=8 occurs if the LRECL is greater 
than 80. Either of these conditions is acceptable. 


For DMSLBM, verify MACLIB integrity wiht the 
MACLIB MAP command. 


For DMSLIO and DMSMOD, reissue the entire 
LOAD/INCLUDE sequence after checking the 
error conditions. 


The problem may be that the in-core directory for 
the M-disk that contains the file being loaded, does 
not match the actual directory. The real disk 
directory may have been changed since the disk was 
last accessed, or if on the system disk, the saved 
system may need resaving. 


For error code ‘09’, issue an FSCLOSE macro for 
the file. If a permanent disk read error occurs 
(code 3), it may be the result of the user having 
detached a virtual disk without releasing it. CMS, 
not realizing that the disk is no longer a part of the 
virtual machine, assumes that the disk is still active 
and encounters an error when it tries to read or 
write the file. 


For VMFPLCD, if processing is not started from 
the beginning, care should be taken to reposition 
the envelope record pointer using the positioning 
commands, as the resulting state of the record 
position is not predictable after this error. 


Appendix J. Messages 873 


105S Error nn writing file {fn ft fm [{on disk|to 


XEDIT}] [RC=rc from command] 


Explanation: An irrecoverable error occurred while 
writing on disk. nn indicates the nature of the 
error; it may be one of the following: 


Code Meaning 

2 The virtual storage address is 0. 

4 The first character mode is invalid. 

5 The second character mode is invalid. 
6 


The number of records in the file is too 
large; it cannot exceed 65,533. 


7 An attempt has been made to skip over an 
unwritten variable-length item. 


8 The number of bytes was not specified. 
9 The file is already active for reading. 


10 The maximum number of CMS files (3,400) 
has been reached. 


11 The fixed/variable flag is not F or V. 
12 The disk is not a CMS read/write disk. 
13 The disk is full (recoverable error). 


14 The number of bytes to be written is not 
integrally divisible by the number of records 
to be written. 


15 The length of this record is not the same as 
that of the previous record. 


16 The fixed/variable flag is not the same as 
that of the previous record. 


17 A variable-length record is greater than 65K 
bytes. 


18 The number of records is greater than | for 
variable-length file. 


19 The maximum number of data blocks per 
file (16,060) has been reached. 


20 An invalid character has been detected in 
filename. 


21 An invalid character has been detected in 
filetype. 


22 Virtual storage capacity has been exceeded. 
25 Insufficient virtual storage is available. 


26 Requested item number is negative, or item 
number plus number of items exceeds file 
system capacity. 
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27 An attempt was made to update a variable 
length item with one of a different length. 


System Action: Execution of the command 
terminates. The system status remains the same. 


For DMSDSK, the reader file is saved. The status 
of the output file is unpredictable. 


For DMSEDI, the edit session terminates. The 
status of the file is as it was before the edit session 
or at the execution of the last SAVE subcommand 
or automatic save. The RENUM workfile is 
erased. A workfile, EDIT CMSUTI, may have 
been created on the input disk. 


For DMSEXL, the file specified in the 
EXECLOAD command was not loaded into 
storage. The execution of the command its 
terminated. 


For DMSDSL, the condition of the DOSLIB file is 
unpredictable. 


For DMSLBM, the condition of the MACLIB file 
is unpredictable. 


For DMSLBT, DMSLST, DMSMOD, DMSSRT, 
DMSTPD, and DMSUPD, the status of the output 
file is unpredictable. 


For DMSRDC, the reader is closed with a HOLD 
status to preserve the file. However, if nn=13 and 
the error occurs while writing the last block of the 
file to disk, then the file will have already been 
purged before the reader is closed. 


For DMSTPI, if the DEN, TRTCH, 7TRACK, 
STRACK, or 18TRACK options were specified, the 
modeset byte has been set for the specified device 
(TAPn, where 7 is a character from 0 to 9 or A to 
F; the default is TAP1). The status of the output 
file is unpredictable. The tape may not be in the 
same position as before the command was entered. 


For DMSXCP, the EXCP request fails with the 
return code nn. Check the attributes of the file 
specified in the DTF and DLBL. 


For DMSXFD, if the error occurred during a FILE 
or SAVE, a temporary work file, XEDTEMP 
CMSUTI, may have been created on the input 
disk. 


For DMSXPT, if the error occurred during a PUT 
(D) operation, the subcommand is terminated and 
the editing session continues. 


For DMSXRE, if the error occurred during a 
RENUM operation, the subcommand is terminated 
and the editing session continues. RC=100. 


User Response: If you can determine the problem 
from the “Explanation” above and remedy the 
condition, reissue the command. If not, reissue the 
command, and if the problem persists, call your 
system support personnel. 


For DMSDSL, use the DOSLIB MAP function to 
verify DOSLIB integrity. 


For DMSLBM, use the MACLIB MAP function to 
verify MACLIB integrity. 


For DMSLIO, reissue the LOAD/INCLUDE 
sequence from the beginning, after checking the 
above error conditions. 


For DMSXCP, specify a smaller partition with the 
SET DOSPART command, or use the CP define 
storage command for a larger machine and IPL 
CMS. 


For VMFPLCD, before reentering the command, it 
may be necessary to reposition the envelope file. 


814E 


¢ Message number nnnn, format nn, line nn was 
not found; it was called from routine in 
application applid. 


Formats for the message follow: 


Explanation: The message requested could not 
be found in the specified repository. 


System Action: RC= 12. 


User Response: Verify the command and 
reissue it. 


e¢ {Message number|Dictionary item} mnnn, 
format nn not found 


Explanation: VMFPLC or VMFPLCD issued a 
request to VMFPLCM to issue a message or to 
retrieve a dictionary item. The message number 
or the dictionary item number is not supported 
by VMFPLCM. 


System Action: If a message number was not 
found, the action is dependant upon the error 
detected by the program requesting the message 
to be issued. For dictionary items, the resulting 
output which was to use the dictionary item 
will be incorrect or untranslated. RC=12. 


User Response: This is an internal error to the 
VMFPLC EXEC or VMFPLCD EXEC. The 
problem should be reported to your IBM 
Service Representative for correction. 


961E There are class class files in the device 


Explanation: A virtual device (RDR, PRT, or 
PUN) has been checked and found to have files of 
the indicated class when none were expected. 


System Action: Processing end, RC= 100. 


User Response: Change the class of the files in the 
device, move them, or purge them. Run the 
program again. 


1447E Invalid command format 


Explanation: Either the VMFPLC ROUTE 
command was issued with TAPE routing specified 
and there were parameters beyond the TAPE 
parameter, or the VMFPLC ROUTE command 
was issued with DISK routing specified and a 
partial envelope file ID was provided. For DISK 
routing, the envelope file ID, if provided, must 
specify the fn ft fm. 


System Action: No action taken. RC=24. 


User Response: Reenter the command in the 
correct format. 


1448E Options option... option invalid for 


function 


Explanation: The identified options are invalid for 
the function requested. 


System Action: Processing is terminated. The 
position in an existing envelope, if any, is not 
affected. RC=24. 


User Response: Reenter the command with a valid 
combination of functions and options. 


1450S Output file fn ft fm disk is read-only 


Explanation: Attempted to write to the identified 
file, which is on a read-only disk. 


System Action: Processing is terminated. RC=36. 


User Response: Correct the disk access to 
read/write and reenter the command. It may be 
necessary to reposition the envelope file prior to 
reentering the command. 
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1451S Cannot dump an envelope file to itself. 


File fn ft fm is the same envelope file. 


Explanation: Attempted to dump the identified file 
to an envelope file and the file is either the envelope 
itself or a copy of the envelope file under a different 
file ID. 


System Action: Processing is terminated. RC=32. 


User Response: Correct the command so that it 
does not dump the identified file. Prior to 
reentering the command, the envelope record 
position should be reset to a valid point for 
continuation using the various positioning 
commands. 


1452S Unidentifiable envelope control record in 


Sn ft fm 


Explanation: A record was encountered in the 
envelope file that has a prefix which identifies it as 
a VMFPLCD control record but which is neither a 
group separator record nor a file header record. 


System Action: Processing is terminated. 
RC = 100. 


User Response: Reposition the envelope file using 
the positioning commands and reenter the failing 
command. If the failure persists, contact your IBM 
Service Representative for assistance. 


1453S Loading of file /n ft fm would overlay 


envelope. 


Explanation: During a LOAD operation, a file was 
found which, if loaded, would overlay the envelope 
file (this may occur, for example, if a file that is 
being loaded has the same file ID as the envelope 
file). 


System Action: Processing is terminated and the 
position within the envelope file is left at the file 
that caused the failure. RC =32. 


User Response: Rename the envelope file or 
change the filemode to which the files from the 
envelope are to be loaded. If the envelope file 1s 
renamed, it will be necessary to reposition the 
envelope using the new name before proceeding. 
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1454S Date/Time stamp update on fn ft fm 


failed. 


Explanation: After a file was loaded, an attempt to 
update its date/time stamp to the value of the file 
when it was dumped failed. 


System Action: Processing is terminated and the 
position within the envelope file is left at the file 
that caused the failure. RC=104. 


User Response: Ensure that the DMSPLU 
MODULE used to update the date/time stamp 1s 
available. Reposition the envelope file if required 
and reenter the command. 


1455S Error occurred trying to truncate file fn 


St fm 


Explanation: A DUMP or WGS command was 
issued while the envelope file was positioned at 
other than the end of the file. As a result, an 
attempt was made to truncate the existing envelope 
prior to the DUMP or WGS. An error was 
detected while truncating the file. 


System Action: Processing is terminated and the 
status of the envelope file is unpredictable. 
RC= 100. 


User Response: The envelope file will need to be 
rebuilt from the start. 


1456S Unexpected error rexx code from 


VMFPLCD. 


Explanation: Syntax error in the VMFPLCD 
EXEC was found by REXX. The REXX code 
identifies the type of error. 


System Action: Processing is terminated. The 
results of the error are unpredictable. RC=104. 


User Response: This may be an internal logic error 
in the VMFPLCD EXEC. Contact your IBM 
Service Representative for help. 


1457E Envelope file was not specified. 


Explanation: The VMFPLCD command did not 
specify the file ID of the envelope file and no 
GLOBALYV variable exists that specifies the file ID. 


System Action: Processing is terminated. RC=24. 


User Response: Reenter the command specifying 
the file ID of the envelope file to be processed or 
created. 


1458E File designated as envelope on function is 


not an envelope 


Explanation: The first record in the file designated 
as the envelope is not a VMFPLCD generated 
control record; thus, the file is not an envelope file. 


System Action: Processing is terminated. RC = 32. 


User Response: Correct the file ID on the 
command to point to an envelope file. 


1459S Number of records for file fn ft fm 


different than when dumped. 


Explanation: A file was found during a LOAD 
operation that contains a different number of 
records than when it was originally dumped. 


System Action: Processing is terminated and the 
position within the envelope is left at the start of 
the file causing the error. RC= 40. 


User Response: Reposition the envelope and retry 
the command. If the failure persists, the assistance 
of your IBM Service Representative may be 
required to determine the cause. 


1460E Envelope file fn ft exists but is on R/O 


extension of the fm disk. 


Explanation: The envelope file specified on a 
DUMP or WGS function does not exist on the 
requested filemode, but a file with the same 
filename and type exists on a read-only extension of 
that filemode. 


System Action: Processing is terminated. The 
position in an existing envelope file, if any, is not 
affected. RC=36. 


User Response: If the envelope file ID is correct, 
either do not make the other mode a read-only 
extension, or rename the file on that extension 
before reentering the command. If the file ID was 
not the one desired, reenter the command with a 
new envelope file ID. 


1801E There is no tape mounted on 181. Mount 
the correct tape and restart the receive 


procedure. 
or 


An envelope formatted file cannot be 
located. 


Explanation: 


Version 1: VMFREC expects a tape to be mounted 
on 181 and there was not. 


Version 2: The envelope file following the ENV 
keyword could not be located on any accessed disk. 


System Action: VMFREC exits with RC=100. 
User Response: 


Version 1: Mount tape to be received and restart 
VMFREC. 


Version 2: Verify the file specification and location 
of the envelope file. Reenter the command with the 
Correct parameters. 


1802R The {tape mounted|envelope} is at a 
lower service level than the existing 
service map. 

The service {tape|envelope} is at service 
level levell. 

The SERVICE DISKMAP file indicates 
service level /evel2. 


Is this what you want? (YES/NO) 


Explanation; VMFREC will receive data from a 
PUT that is at a lower level than was previously 
received. 


System Action: If response to prompt is no, then 
VMFREC exits. Otherwise, receive procedure 
continues. 


User Response: Respond to prompt, either YES or 
NO. 


1803E The tape is in the wrong format. Mount 
the correct tape and restart the receive 


procedure. 
or 


The envelope is in the wrong format. 
Check the syntax and reenter the 
command with valid envelope parameters. 


Explanation: 


Version 1: VMFREC expects the first tape file to 
contain a file that determines the tape type. This 
file is either incorrect or not present. 


Version 2: VMFREC uses the first file within the 
envelope file to determine envelope type such as 
COR or PUT. This file is incorrect or not present. 
The envelope type cannot be determined. 


System Action: VMFREC exits with RC= 100. 


Appendix J. Messages 9877 


User Response: 
Version 1: Mount the correct tape. 


Version 2: Reenter the command with the name of 
a valid envelope file following the word ENV. 


18041 Receiving service for [component comp 
of] product prodid | 


Explanation: This is an informational message 
indicating which component or product service is 
being received for. 


System Action: VMFREC continues receiving 
service. 


User Response: None. 


1805E [No|Not enough] parameters were 
entered. Check the syntax and reenter 
the command. 


Explanation: An attempt was made to execute a 
procedure, but the required parameters were not 
entered. 


System Action: The procedure exits with RC =8. 


User Response: Review the documentation and 
restart the procedure with correct parameters. 


18061 The current SERVICE DISKMAP file 
contains the map of the {mounted 
tape|current envelope}. 


Explanation: An informational message indicating 
that the tape currently mounted or the envelope 
being used has been previously mapped. 


System Action: VMFREC continues receiving 
service. 


User Response: None. 


1807E routine cannot continue; the filename 
filetype file was not found. 


Explanation: A procedure requires a file that 
cannot be found on an accessed minidisk. 


System Action: The procedure exits with RC=28. 


User Response: The file named in the message 
needs to be made available. Verify that the 
minidisk access is as it should be. Check the 
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product parameter file to verify that the correct 
minidisk is listed in the component minidisk 
assignment (MDA) section. 


1808E The ppfname $PPF product parameter 
file was not found. 


Explanation: A procedure requires a product 
parameter file in order to set required parameters, 
and the file cannot be found on an accessed 
minidisk. 

System Action: The procedure exits with RC=28. 


User Response: The file named in the message 
needs to be made available. Verify that the 
minidisk accesses are as they should be. 


1809E A function {tape|disk} error has occurred 
with return code rc. 


Explanation: VMFREC has encountered a serious 
tape or disk error. 


System Action: The procedure exits with the return 
code received from the VMFPLC2 command. 


User Response: Correct the tape or disk drive 
problem as indicated by the rc from the VMFPLC2 
command. If drive is working then the tape or disk 
might not be in the correct format for the 
procedure. 


1810R Enter a component name or type QUIT. 


Explanation: The procedure needs a component 
name in order to carry out its function. 


System Action: The procedure waits for a valid 
component name to be entered or QUIT. 


User Response: Enter a component name listed in 
the product parameter file for the product 
requested. 


1811W The access of vdev failed for product 


prodid. 


Explanation: An access command has failed for the 
minidisk listed in the message text. 


System Action: The procedure exits with RC=4. 


User Response: Verify that the minidisk is linked 
correctly. 


1812E Service for prodid is not {on|in} the 
{mounted tape|current envelope} but the 
prodid product ID is in the SERVICE 
DISKMAP file. It is {onjin} the service 
{tapejenvelope} mapped with a relative 
{tape|envelope} number of number. 


Explanation: The wrong tape volume is mounted 
on tape 181, or the wrong envelope has been 
specified. 


System Action: The procedure exits with RC =28. 


User Response: Mount the correct tape volume or 
specify the correct envelope and restart the 
procedure. 


1813E option! and option2 are conflicting 
options. Check the syntax and reenter 
the command. 


Explanation: Conflicting options have been 
entered. 


System Action: The procedure exits with RC=8. 


User Response: Check the documentation, then 
restart the procedure using correct command 
syntax. 


1814E Service for the product ID prodid is 
{onlin} the {mounted tape|current 
envelope}, but the prodid product ID is 
not in the SERVICE DISKMAP file. 


Explanation: The tape or envelope has not been 
mapped correctly. 


System Action: VMFREC exits with RC=28. 


User Response: Erase existing service map and 
restart VMFREC. 


1815E parameter is an unknown parameter. 
Check the syntax and reenter the 
command. 


Explanation: An unknown parameter was detected 
by the procedure. 


System Action: The procedure exits with RC =8. 


User Response: Check the documentation, then 
restart the procedure using correct command 
syntax. 


1816E parameter is an unknown parameter. 
This product ID is not {on the tapejin the 
envelope} or in the SERVICE 
DISKMAP file. 


Explanation: The first or only parameter entered is 
invalid. 


System Action: The procedure exits with RC=8. 


User Response: Check that the product ID that 
was entered is valid. 


1817E The updateid-name update ID is not in 
the filename CNTRL file. 


Explanation: The update ID entered on the 
command line, or listed in the product parameter 
file, was not found in the control file listed in the 
product parameter file. 


System Action: The procedure exits with RC=28. 


User Response: Verify that the correct update ID 
was entered, either on the command line or in the 
product parameter file, according to the procedure 
syntax. Check that the correct control file is listed 
in the component section of the product parameter 
file. 


1818E The product service header file cannot be 
found. 
The {tapelenvelope} positioning might be 
in error. 
Restart the receive procedure beginning 
with service for product ID prodid. 


Explanation: VMFREC can not find the product 
header file on the tape in the tape file calculated, or 
in the envelope at the file location calculated. 


System Action: VMFREC exits with RC=28. 


User Response: The tape or envelope positioning 
might be incorrect upon return from an 
unsupported product service EXEC. If this is 
thought to be the case, restart the procedure 
beginning with the product listed in the message 
text. If this is not the case, the file counts in the 
component list of the product parameter file might 
be incorrect. 
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1819E The control file filename filetype was not 


found. 


Explanation: The control file listed in the 
component section of the product parameter file 
cannot be found. 


System Action: The procedure exits with RC = 28. 


User Response: Verify that the control file listed is 
correct, and that the minidisks are accessed 
correctly. 


The build list filename filetype was not 
found. 


1820E 


Explanation: The build list listed in the component 
section of the product parameter file cannot be 
found. 


System Action: The procedure exits with RC=28. 


User Response: Verify that the build list listed is 
correct and that the minidisks are accessed 
correctly. 


1821E All filemodes are being used. The 


previous access order will be restored. 


Explanation: Access to required minidisks failed 
because no filemodes were available. 


System Action: The procedure exits with RC=100. 


User Response: Release unwanted minidisks. 
Reduce the number of minidisks listed, as required 
in the component section of the product parameter 
file. 


1822W Access to vdev cannot be restored. 


Explanation: Upon exit, the procedure could not 
reaccess the minidisk listed. 


System Action: The procedure continues with 
RC=4. 


User Response: Upon exit, reaccess the minidisk if 
needed. 


1823W The filename filetype PTF parts list file 
was not found. A PTF might be missing 


for product ID prodid. 


Explanation: A file listed in a PTF parts list could 
not be found. 


System Action: The procedure continues with 
RC=4. 
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User Response: Investigate why the PTF part is 
missing. Check the minidisk assignments (MDA) 
section for the component in the product parameter 
file. 


1824E vdev, accessed as filemode, is not R/W. 


Explanation: The procedure requires the minidisk 
listed in the message text to be read/write. 


System Action: The procedure exits with RC= 100. 


User Response: Reaccess the minidisk as 
read/write, and restart the procedure. 


1825W A part handler cannot be found for part 
part-type while applying PTF pifnum to 


product ID prodid. 


Explanation: A part is listed in the component 
section of the product parameter file with a 
part-specific EXEC that cannot be found on an 
accessed minidisk. 


System Action: The procedure continues with 
RC=4, 


User Response: If this was a part that was 
intentionally bypassed, then no action is required. 
Otherwise, find the part listed in the component 
section of the product parameter file and verify the 
listed part handler spelling. Check the minidisk 
accesses for correctness. 


1826W The part type filename filetype was not 
found while executing the name part 


handler. 


Explanation: A part listed in the component 
section of the product parameter file cannot be 
found on an accessed minidisk. 


System Action: The procedure continues with 
RC=4., 


User Response: Find the part listed in the 
component section of the product parameter file 
and verify that the part is spélled correctly. Verify 
the minidisks are accessed correctly. 


1827S The name part handler failed for part fn 
ft while applying PTF pt/num for product 


ID prodid. 


Explanation: The part handler listed in the 
message text failed. 


System Action: The procedure exits with RC=100. 


User Response: Determine the cause of the part 
handler failure by examining its error messages. 


1828W The prefix xxx is listed in the control file 
filename, but a PTF number cannot be 


found. 


Explanation: A prefix (xxx) has been listed on a 
control file level indicating that the text deck will be 
named by a PTF number, but an auxiliary control 
file containing a valid PTF number cannot be 
found. 


System Action: RC=4. 
Text deck is named according to the control file 
without the use of a PTF number. 


User Response: Check the control file and auxiliary 
control structure. 


1829W The filename filetype update cannot be 


applied. 


Explanation: The VMFAPTXT part handler failed 
while attempting to apply the update listed in the 
message text. 


System Action: The procedure continues with 
RC =4. 


User Response: Examine previous messages to 
determine the cause. 


1830E label has been specified as the target for 
the component compname of product 
prodid. There is no target listed on the 


label tag. 


Explanation: A symbolic string has been specified 
as a target, but the label in the minidisk 
assignments (MDA) section of the $PPF file does 
not contain any minidisk address. 


System Action: The procedure exits with RC = 100. 


User Response: Correct the MDA section in the 
file and reinvoke the procedure. 


—- see ser eee aoe 


1831. W PTF ptfnum is included in filename 
filetype. It is in the exclude list 
filename2 filetype2, but cannot be 


excluded. 


Explanation: The PTF specified in the SEXCLIST 
is contained in a part of the PTF being applied. 
VMFAPPLY can only exclude PTFs serially from a 
text deck (the last PTF applied). 


System Action: The procedure continues with 
RC=0. 


User Response: Refer to VM/XA SP Installation 
and Service for instruction on how to process PTFs 
that could not be excluded by VMFAPPLY. 


1832W Text deck filename filetype is included in 


the name build list but cannot be found. 


Explanation: A text deck, listed in the build list to 
be included in the build, cannot be found on an 
accessed minidisk. 


System Action: The procedure continues with 
RC=4. 


User Response: Check that the correct minidisks 
are listed in the component section of the product 
parameter file. Verify that this deck was 
intentionally removed from the access order. 


1833W Text deck filename filetype does not 
contain any executable code but is listed 
in the name build list. The build process 


might not be complete. 
or 


Text deck filename filetype has been 
selected as the highest level deck 
according to the AUX file structure but it 
does not contain any updates. The build 
process might not be complete. 


Explanation: 


Version 1: A text shell (a text deck that contains 
only requisite information) has been found. It ts 
listed in the prologue of another text deck as an 
update. 


Version 2: While examining the control file to locate 
the latest text deck an AUX or update file was 
located. This indicates the deck identified in the 
message as the latest. The existence of the AUX or 
update file also indicates that the deck has been 
updated but the self-documenting prolog does not 
contain any update or AUX file entries. Entries 
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may have been added to the control or AUX file 
but not assembled into the deck. 


System Action: The procedure continues with 
RC=4. 


User Response: 
Version 1: Investigate why this text deck is missing. 


Version 2: Examine the control file and associated 
AUX files to verify that all updates have been 
correctly assembled into the textdeck. Examine the 
text deck prolog to ensure the update entries are in 
the correct format. 


1834W The filetype of filename filetype might be 


incorrect due to preferred AUX files. 


Explanation: The filetype of a text deck was found 
on a level of the control file that also contains 
preferred files. 


System Action: The procedure continues with 
RC=4, | 


User Response: Check the control file named in the 
component section of the product parameter file for 
correctness. 


1835E AUX file filename auxft on vdev could 
not be saved by XEDIT when adding 
update filename update-ft. PTF(s) 
included in filename might be partially 


applied. 


Explanation: VMFAPPLY could not completely 
process all the changes included in the text deck 
that is a part of the PTF being applied. 


System Action: The procedure exits with RC= 100. 


User Response: Add another APPLY minidisk to 
the $PPF file or increase the size of the current 
APPLY minidisk and restart VMFAPPLY. 


1836E This program requires [filemode A|mode | 


to be accessed as R/W. 
[Access mode A as R/W and re-try. ] 


Explanation: The procedure cannot continue 
without the indicated read/write filemode. 


System Action: The procedure exits with RC = 100. 


User Response: Access a read/write filemode A and 
restart the procedure. 
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1837W _ filename filetype filemode update entries 
do not match the control file for update 


filename filetype. 


Explanation: While checking the entries in the text 
deck with the AUX entries in the AUX file and 
update entries in the control file, a mismatch has 
been detected. 


System Action: The procedure continues with 
RC=4. 


User Response: Investigate the problem with 
textdecks not matching the AUX file and control 
file. 


1838E The service exec requires filemode C to 
be accessed as R/W. Access mode C as 


R/W and retry. 


Explanation: For a product with its own service 
EXEC, a read/write filemode C must be accessed. 


System Action: The procedure exits with RC=100. 


User Response: Access a read/write filemode C and 
either copy the existing SERVICE DISKMAP for 
filemode A to filemode C, or erase any on filemode 
A before reinvoking VMFREC. 


1839W Multiple update files for product ID 
prodid have been found on: vdev 


Explanation: Duplicate update files exist on 
different minidisks for the same product. 


System Action: The procedure continues with 
RC =4. 


User Response: Be aware that, with multiple 
updates, there is a possibility that the wrong decks 
can be picked up at build time. 


1840W The AUX file entries in filename/ 
filetypel filemodel and filename2 


filetype2 filemode2 do not match. 
or 


filename filetype filemode contains AUX 
entries but an AUX file has not been 
located. 


Explanation: While comparing AUX entries 
between the given text deck and AUX file or 
between the two given AUX files, a mismatch has 
been detected. The PTF that was being processed 


when the error was detected may be partially 
applied. 


System Action: The procedure continues with 
RC =4, 


User Response: Investigate the reason for the 
mismatch, correct it, and retry the procedure. 


1841W The filename filetype update file was not 
found. 


[An update shell has been created. ] 


Explanation: An update file pointed to by an entry 
in a text deck prologue or an AUX file could not 
be found on an accessed minidisk. Update shells 
are only created for text decks. When the update 
file is for another type of part (for example, a 
MACRO or an EXEC), the second part of this 
message is not issued and no update shell is created. 


System Action: The procedure continues with 
RC =4, 


User Response: Investigate why the update file 
listed in the message text was not found. 


1842W The filename filetype file was not found. 
The exclude option was ON but there is 
no exclude list. The process is continuing 


with the exclude option set OFF. 


Explanation: VMFAPPLY cannot locate the 
$EXCLIST file for the control file specified in the 
product parameter file. 


System Action: The procedure continues with 
RC=4. 


User Response: Investigate why the $EXCLIST file. 


listed in the message text was not found. 


1843W The filename filetype update cannot be 
applied for PTF pifname. vdev must be 


R/W. 


Explanation: The update files are marked 
“applied” by renaming from filemode number | to 
5. The disk that the files reside on must be 
read/write in order to rename. 


System Action: The procedure continues with 
RC =4. 


User Response: If the update file should have been 
applied, then move the file to a read/write minidisk 
and restart the procedure. 


1844W For product prodid, PTF ptfnum part fn 


ft was not found. 


Explanation: A part listed in a PTF part list could 
not be found. 


System Action: The procedure continues with 
RC=4. 


User Response: Investigate why the part was not 
found. 


1845W _ filename filetype file is a text deck shell 
for PTF ptfnum. 


Explanation: A text deck that is listed as a part of 
the PTF listed in the message text could not be 
found. 


System Action: The procedure continues with 
RC=0. 


User Response: Investigate why the deck was not 
found. This situation can occur when applying 
more than one PTF which affects the same part. If 
a text deck is shipped for the part and the part is 
source-maintained, only the text deck for the latest 
PTF is sent. When this text deck is received during 
VMEFREC, text deck shells are created for any 
included PTF for which a full text deck does not 
exist. Only the latest text deck is sent for 
source-maintained parts because all other levels of 
the text deck can be obtained by assembling the 
source with the appropriate updates applied. 


During VMFAPPLY, this message is issued 
whenever a text deck listed as part of a PTF isa 
text deck shell rather than a full text deck. 
Normally, these messages will be removed from the 
APPLY error log when a PTF is applied for, which 
a full text deck exists. However, if apply processing 
stops before such a PTF is applied these messages 
will remain in the error log. You should determine 
why apply processing has stopped and run 
VMFAPPLY again. 


1846W Update file /n ft has a requisite of 
ptfnum. The update file for part 
part-type cannot be found on a R/W 
disk. The DEPEND entry cannot be 


entered. 


Explanation: A text deck contains a requisite that 
points to an update file that cannot be found, ora 
depend entry cannot be written because the update 
file is on a R/O disk. The depend function is 
bypassed. 
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System Action: The procedure continues with 
RC =4, 


User Response: Investigate why the requisite 
update file was not found. 


1847W  ptfnum! is referenced in update file fn ft 
and is a part of PTF pt{fnum2. ptfnum! 


is a requisite for another component. 


Explanation: This is a warning message, indicating 
that a requisite exists that is outside of the 
component. 


System Action: The procedure continues with 
RC=0. 


User Response: None. 


1848E filename ptf-ft on vdev could not be 
copied/renamed to base-ft on vdev. AUX 
files and update files show all service in 
text deck filename ptf-ft has been 


applied. 


Explanation: VMFAPPLY could not complete 
processing a text deck that is part of the PTF. The 
text deck being processed needs to be renamed to 
its base filetype, and copied to the minidisk 
identified in the message. This text deck is not 
supported by VMFBLD. 


System Action: The procedure exits with RC = 100. 


User Response: Copy and rename the text deck 
identified in the message to another minidisk listed 
for the component in the $PPF file, or increase the 
size of the current DELTA minidisk and 
copy/rename the text deck. 


1849W APAR aparnum! is a requisite of APAR 
aparnum2 and the aux entry 
update-file-type is not included in the self 
documenting prolog information of the 


text deck filename filetype. 
or 


APAR aparnum is a required requisite, 
but part filename filetype on disk address 
has not been applied by VMFAPPLY 
and the update file is not fmS. 
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Explanation: 


Version 1: An update file was found for the text 
deck listed in the message and this update file was 
not included in the self documenting prolog 
information of that text deck. 


Version 2: An update file was found for the APAR 
listed in the message and this update file was not 
applied by VMFAPPLY. 


System Action: The procedure continues with 
RC=4. 


User Response: 


Version 1: Investigate why the aux entry identified 
in the message is missing from the updated text 
deck. The text deck may have been built without a 
requisite APAR. 


If this text deck was built by IBM, this text deck is 
in error. Report this to your IBM service 
representative. 


If the text deck was built locally, you may have left 
out a required entry in an aux file for the text deck 
identified in the message. Correct the aux file and 
run VMFBLD again. 


Version 2: Investigate why this update file has not 
been applied. 


18501 The processing for part-name by the 
filename EXEC was bypassed. 


Explanation: Processing of a part has been 
bypassed. This could occur if the part handler has 
been commented out in the product parameter file. 


System Action: The procedure continues. 


User Response: If the part was expected to be 
handled, investigate why the part handler EXEC 
was not found. 


1851] Processing filename filetype with the part 
handler parthandler EXEC. 


Explanation: This is an informational message 
indicating that the function requested is progressing 
to the next part. 


System Action: The procedure continues. 


User Response: None. 


1852] This is volume-number of total-volumes, 
level level {PUT|COR} {tape|disk}. 


Explanation: An informational message indicating 
the level of the tape or disk being processed. 


System Action: The procedure continues. 


User Response: If you are using the correct tape or 
envelope level, then no response is needed. 
Otherwise, stop the procedure, mount the correct 
tape or use the correct envelope, and restart 
procedure. 


1853] Processing PTF pifnum. 


Explanation: This is an informational message 
indicating that the function requested is progressing 
to the next PTF listed in the PTF parts file. 


System Action: The procedure continues. 


User Response: None. 


1854W = ptfnum is a requisite for another 


component. 


Explanation: This message indicates that a PTF 
has been found that lists a requisite that is not a 
part of the component being processed. 


System Action: The procedure continues with 
RC=4., 


User Response: Verify that the out-of-component 
requisite will be applied. 


1855W Control file fn contains invalid data. 
Text deck fm will not be named by PTF 


number. 


Explanation: A record was found in the control file 
that violates the control file rules as defined in 
VM/XA SP CMS Command Reference under the 
UPDATE command. 


System Action: RC=4. 
The text deck is named according to the control file 
without the use of a PTF number. 


User Response: Check the control file and AUX 
structure for invalid level IDs or update identifiers. 


1856! PTF ptfnum is in the filename filetype 
exclude list for product ID prodid , and 
will not be applied. 


Explanation: This is an informational message 
indicating that a PTF listed in the apply list will not 
get applied, because it is also listed in the exclude 
list. 


System Action: The procedure continues. 


User Response: None. 


18571 APAR aparnum is a required requisite, 
but part filename! filetypel on disk disk 
address has not been applied by 
VMEFAPPLY and the update file is not 
fm5. 


Explanation: A textdeck includes a requisite which 
has an update that has not been applied as 
indicated by a filemode other than fm!/. 


System Action: The procedure continues with 
RC=0. 


User Response: The message is informational. The 
part identified in the message text is a part that 
must be processed manually. VMFAPPLY changes 
the filemode of update files for TEXT decks to a 5 
when processed. Update files for other parts, such 
as EXECs, XEDIT macros, MACROs and COPY 
files, will force this message to be issued since 
filemodes on update files for these parts are 1 
(VMFAPPLY does not process these update files). 
The message can be eliminated by changing the 
filemode on update files for these other parts to a 5. 
Next time VMFAPPLY is run (you do not have to 
run VMFAPPLY again now), these messages will 
not be issued. 


1858I message 


Explanation: The variations of this message are 
explained below. 


System Action: In each case, the procedure 
continues. 


User Response: In each case, refer to VM/XA SP 
Service Guide for instructions on how to regenerate 
service parts of the system. 
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Messages: 
¢ filename build list contains files that have been 
serviced. 


Explanation: VMFAPPLY has processed a PTF 
that contained a new level of a file contained in 
the build list found in the build (BLD) section 
of the product parameter file. VMFBLD 
should be invoked to regenerate the object 
associated with the build list, such as the 
nucleus and the module. 


e filename filetype has been serviced. 


Explanation: VMFAPPLY has processed a PTF 
that contained a new level of the file identified 
in the message. A build step might be required 
to make the change available for execution. 


18591 The name build exec completed with 
return code rc. 


Explanation: The part handler identified has 
completed the build step required for a build list 
specified in the product parameter file. 


System Action: The procedure continues, with 
RC=re. 


User Response: None. 


1860E compname is an invalid component name 


for product ID prodid. 


Explanation: The base compname listed on the 
override compname tag was not found in the 
complist tag. 


System Action: The procedure exits with RC = 100. 


User Response: Verify that the override and 
complist tags match. If not, change the tag that is 
incorrect. | 


18601 compname is an invalid component name 
for product ID prodid. 


Explanation: A component name has been entered 
for a product that does not contain that 
component. 


System Action: The procedure continues and 
prompts you for a valid compname. 


User Response: Respond to the prompt by entering 
a valid compname. 
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The filename service exec completed with 
return code rc message. 


1861W 


Explanation: The service EXEC has completed the 
task. The return code (rc) indicates whether the 
exec was successful or not at completing the task. 
message may be one of the following according to 
the return code (rc) specified: 


¢ rc=0 
The service has been received. 


VMFREC has invoked a product service 
EXEC, and the EXEC has completed 
successfully. 


°° 0<rc<4 


The service received might have been done 
previously. 


VMFREC has invoked a product service 
EXEC, and the EXEC has completed 
successfully. Service for this EXEC may have 
already been received before. 


e3<re<8 
Service received, a build might be required. 


VMFREC has invoked a product service 
EXEC, and the EXEC has completed 
successfully. The product for which service was 
received may need to be rebuilt in order to 
apply the service. 


User Response: Review service procedures for 
the product service to check if a build is 
required. 


© 7<re< 12 


Receive has been discontinued, some service may 
have been received. 


VMFREC has invoked a product service EXEC 
and the EXEC was halted before service was 
completely received. 


User Response: Correct the problem that 
caused the product service EXEC to fail and 
restart VMFREC. 


* re>1ll 


Receive has been discontinued, tape position 
unknown. 


VMFREC has invoked a product service EXEC 
and the EXEC has been halted at an unknown 
point in the process. 


User Response: Correct the problem that 
caused the product service EXEC to fail and 
restart VMFREC. 


System Action: VMFREC exits with rc unless the 
list option was specified, in which case the next 
product in the list is processed. 


User Response: None, unless otherwise indicated 
above. 3 


18621 The LTO option was specified, but not 
all targets are accessed R/W as required. 
The LTO option has been set OFF. 


Explanation: In order to specify the last-text-only 
option, the target minidisks must be accessed as 
read/write. 


System Action: The procedure continues with the 
last-text-only option turned off. 


User Response: If the last-text-only option is 
desired, stop the procedure and reaccess the target 
minidisks in write mode, then restart the procedure. 


Service has been received on the S 
minidisk. Module generation and/or 
reIPL of CMS might be required. 


Explanation: Service has been received onto the 
system minidisk. 


System Action: RC=4. 


1863W 


User Response: The system minidisk needs to be 
re-IPLed, or the CMS segment might need to be 
resaved. 


1864E Service exec previously failed for prodid 
compnamel! on PUT levell. 

You must rerun service-exec for prodid 
compnamel on PUT level! before 
running service-exec for prodid 
compname2 on PUT level2. 


Explanation: More than one $ER* erase list has 
been found in the access order. Update files from 
the level 1 PUT were not processed completely. 


The variables in the message text are defined as 
follows: 
service-exec The main EXEC name (VMFREC) 
The product ID 


The previously failing component 
ID 


prodid 


compnamel 


levell The failing PUT level 


compname2 The current component ID 


level2 The current PUT level. 


System Action: RC=23 (for merge error). 
The function is terminated. 


User Response: The function cannot be reinvoked 
until one of the duplicate SER* erase lists is 
removed from the access order. The component 
identified in the message text should be run after 
the duplicate file is removed. 


1865W Update files for prodid compname have 
been found on the target. The target 
should be empty. The MERGE tag 
parameter in the $PPF file might be 


improperly specified. 


Explanation: The target minidisk should be empty 
at the start of receive for update files. If the target 
minidisk is listed on the MERGE tag in the PPF 
correctly, the minidisk should be empty. 


System Action: RC=4. A prompt allows the user 
to continue with the process or discontinue receive. 


User Response: Unless the intent is to receive 
updates to a minidisk that has already received 
updates, the user should exit and check the PPF for 
correct string labels on the MERGE tag. 


1866W Duplicate update files have been found in 
the target and APPLY access orders. 
Merge might not have been done 


correctly. 


Explanation: Duplicate update files have been 
found on the target and APPLY minidisk strings. 


System Action: Update file processing continues 
with RC =4. 


User Response: With the proper use of the service 
tools and MERGE tag in the PPF, this situation 
should not occur. Manual file manipulation is 
necessary in order to remove the duplicate files. 


The loadlist loadlist-name EXEC 
[vdev|dirname] does not contain a valid 
loader name. 


1867E 


Explanation: The loader invoked for the build of 
the component being processed is determined by the 
loader card specified in the loadlist identified in the 
‘BLD. section of that component in the product 
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parameter file. This loadlist does not contain a 
loader card that is recognized by the EXEC as a 
valid loader. 


System Action: The procedure exits with RC = 100. 


User Response: Examine the loadlist for a loader 
card. If one does not exist then add one. If one 
does exist then it is not supported by the 
parthandler invoked to process it. Modify the 
product parameter file to invoke a parthandler that 
does support the format of this loadilist. 


1868W Auxfile filenamel filetype! contains 
PTF# ptfnumber but textdeck filename2 
filetype2 could not be located. Search 
will continue with the level ID from the 


control file. 
or 


The control file filename CNTRL 
indicates that part filename filetype 
should exist but it can not be located. 
Searching will continue at the next level. 


Explanation: 


Version 1: In determining the filetype of a textdeck 
using the AUX and control file structure, an 
AUXFILE has been found that contains a valid 
PTF or local tracking number. A textdeck filetype 
formed with this number and prefix cannot be 
located using the current access order. This may 
result in a build being done with a lower level 
textdeck. 


Version 2: In determining the filetype of a textdeck 
using the AUX and control file structure, an update 
or AUX file was specified in the control file, and 
the update or AUX file exists on an accessed disk 
but a part with a filetype of the prefix 
concatenated with the LEVELID could not be 
located. 


This condition may also exist if the update specified 
in the control file contains a prefix but the next 
AUX level points to an AUXFILE that does not 
contain a valid PTF number. In this case, a search 
is made using the LEVELID from the control file 
which may cause the message to be issued as 
described above. 


System Action: In each case, the procedure will 
continue to process the control file searching for a 
textdeck filetype. RC=4. 


User Response: In each case, investigate the access 
order to determine if the textdeck identified in the 
message can be located. If it can be located, either 
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the disk should be added in the PPF, or the 
textdeck copied to a disk that is listed in the PPF. 
If the deck cannot be located, then the module 
should be reassembled. 


1869R prodid compname begins on PUT|COR 
tapenum volume vol. Mount volume vo/ 


and press ENTER or type QUIT. 


Explanation: The service you are receiving for a 
product/component begins on another tape. 


System Action: The procedure continues when you 
press ENTER, or exits if you type QUIT. 


User Response: Mount the tape containing the 
service for the component and press ENTER. 
Alternatively, type QUIT, mount the next tape and 
reinvoke VMFREC to load the rest of the service 
for the component. 


1870R Choose the component which is to be 


processed from the list below: 


Explanation: A procedure has been requested, but 
a component name was not specified. The names 
displayed are taken from the COMPLST and 
OVERLSTP tags in the product parameter file. 


System Action: The system waits for a response to 
the prompt. 


User Response: Enter a component name from the 
list displayed, or enter QUIT. 


1871R 


Explanation: An opportunity is given to 
prematurely exit the procedure. 


Do you want to continue? (YES/NO). 


System Action: The system waits for a response to 
the prompt. 


User Response: Answer the prompt. 


1872E COR is a nonsupported option for the 
prodid product ID. The {tapeljenvelope} 
has been positioned to the beginning of 
the product's first file. Use the product's 


corrective service procedure to process. 


Explanation: The product specified on the 
VMFREC command is not packaged in the format 
required by VMFREC. Refer to the product’s 
documentation for procedure to follow for 
corrective service. 


System Action: The procedure exits with RC=8. 


User Response: None. 


1873W = prodid compname relative 
{tapejenvelope} file number, label is 
listed in the product directory but is not 
in the SPPF file. This {tape|envelope} 


file will not be received. 


Explanation: The product specified on the 
VMFREC command is not packaged in the format 
required by VMFREC. Refer to the product’s 
documentation for procedure to follow for 
corrective service. | 


System Action: The procedure continues with 
RC=4. 


User Response: Correct the receive service 
(RECSER) section in the $PPF file for the 
component specified on the VMFREC command. 
Add the label and part handler for the tape or 
envelope file. 


1874R The execname option {PUT|COR} does 
not match the type of the {mounted 
tape|current envelope} {PUT|COR}. Do 


you want to continue? (YES/NO) 


Explanation: VMFREC is receiving service from a 
preventive or corrective tape or envelope but the 
option specified on the commmand does not match 
the tape or envelope type. 


System Action: The procedure exits if response 1s 
NO, continues if response is YES. 


User Response: Enter YES or NO. 


1875E XEDIT cannot save file filename filetype 
on disk filemode. The return code from 


XEDIT was rc. Correct the problem and 


re-start the procedure from the beginning. 


Explanation: The procedure being run could not 
save the file being edited. The minidisk might be 
full. 


System Action: The procedure exits with RC=100. 


User Response: Look up the return code from 
XEDIT and determine the cause of failure. Correct 
the problem and restart the procedure from the 
beginning. 


1876E The VMFAPPLY option PUT|COR 


does not match the apply list specified. 


Explanation; VMFAPPLY was invoked with the 
PUT or COR option, but the $APPLIST being used 
does not match the option specified. 


System Action: The procedure exits with RC=100. 


User Response: Reinvoke VMFAPPLY, using the 
correct option. 


1877R prodid compname begins on PUT|COR 
tapenum volume vol. Do you want to 


continue? (YES/NO) 


Explanation: VMFREC is receiving service for a 
component that started on a previous tape. You 
should not receive this service if you have not 
already received the service from the other tape. 


System Action: The procedure exits if response is 
NO, continues if response is YES. 


User Response: Enter YES or NO. 


18781 No files have been found for prodid 
compname on the PUT|COR level evel. 


Explanation: VMFREC could not find any service 
for the product/component on the tape that is 
currently mounted. 


System Action: The procedure continues with 
RC=0. 


User Response: Check other tape volumes for this 
service level for the product/component. 


1879R product-name component-name on 
PUT|COR level-number volume 
vol-number continues on volume 
vol-number2. Mount volume vol-number2 


and press ENTER or type QUIT. 


Explanation: The service you are receiving for a 
product/component is continued on another tape. 


System Action: The procedure continues when you 
press ENTER, or exits if you type QUIT. 


User Response: Mount the tape containing the 
remainder of the service for the component and 
press ENTER. Alternatively, type QUIT, mount 
the next tape and reinvoke VMFREC to load the 
rest of the service for the component. 
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1880W $filename filetype is an update file that 
has a requisite for APAR aparnum, but 
no update file can be found. 


Explanation: VMFAPPLY found a requisite 
APAR for the update being applied, and could not 
locate an update file that contained the APAR 
number in the filetype. The filetype of the update 
file being applied could not be added to the 
DEPEND tag for this update. 


System Action: The procedure continues with 
RC=4. 


User Response: Locate the update files for the 
APAR, and add the filetype specified in the 
message to the DEPEND tag. The situation where 
no update files can be found is not an error 
condition if the PTF that corresponds to the given 
ft does not contain any parts that are serviced with 
update files. 


1881W Text deck filename filetype on vdev 
contains an applied update for APAR 
aparnum, but the AUX file cannot be 
found on the APPLY string. The PTF 


was not applied. 


Explanation: The text deck being processed 
contains an update that has a filemode number of 
5, which indicates it has been added to an AUX 
file. VMFAPPLY could not find an AUX file on 
any minidisk listed on the APPLY tag in the $PPF 
file. 


System Action: The procedure continues with 
RC=28. 


User Response: Change the filemode number of the 
update file to a 1 and reinvoke VMFAPPLY, or 
create an AUX file for the text deck on a minidisk 
listed in the APPLY string, and add the update file. 


1882W AUX file filename filetype on vdev is 
inconsistent with the text deck filename 
filetype on yvdev. The PTF was not 


applied. 


Explanation: The text deck being processed 
contains an update that has been applied, but it is 
not contained as the first entry in any AUX file 
found in the APPLY string. VMFAPPLY cannot 
determine where the update being applied should be 
added to the AUX file. 


System Action: The procedure continues with 
RC=4. 
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User Response: Change the filemode number of the 
update file to a 1 and reinvoke VMFAPPLY, or 
add the update to an AUX file for the text deck on 
a minidisk listed in the APPLY string. 


1883W There was a problem loading the apply 
and exclude lists. 


Explanation: VMFREC was not able to 
copy/rename the apply and exclude contained on 
the service tape to the target minidisk. The 
minidisk might be full, or an incorrect level of the 
apply or exclude list might have been shipped on 
the tape. 


System Action: The procedure continues with 
RC=28. 


User Response: Check the target minidisk for the 
correct level of the apply and exclude list. If found, 
then copy/rename them to $APPLIST and 
$EXCLIST. If they are not found, contact your 
IBM support center. 


1884W = ptfnum is an included PTF in filename! 


filetypel. It has been added to filename2 
filetype2 apply list. 


Explanation: While applying a PTF, a text deck or 
AUX file was processed that contained additional 
PTFs that were not in the $APPLIST. 
VMFAPPLY will process these PTFs as if they 
were in the $APPLIST, to ensure that all service 
required for the PTF is applied. 


System Action: The procedure continues with 
RC=0. 


User Response: None. 


1885W filename! filetype! listed in filename2 
CNTRL represents service at a higher 
level than filename! filetype3. The 
higher-level service may need to be 


reworked or removed. 


Explanation: VMFAPPLY found an AUX file or 
update file at a higher level in the control file than 
the AUX file being updated by VMFAPPLY. If 
the file found is an AUX file, its contents follow the 
message. 


System Action: The procedure continues with 
RC=0. 


User Response: The higher-level service must be 
investigated to determine if it conflicts with the new 


service in the AUX file being updated by 
VMFAPPLY. Any service that is duplicated by the 
new service must be removed from the higher level. 
Any service that conflicts with the new service must 
be reworked so that it no longer conflicts. 


1886W Update file filename filetype on addr has 
: a filemode other than fm5 but auxfile 
filename filetype on addr contains an 
AUX entry for this update. The PTF 
was not applied because of this 


inconsistency. 


Explanation: During apply processing of a text 
deck, the deck is read from bottom up looking for 
AUX entries. When an AUX entry is found the 
update filetype is taken from the first field and a 
check has been made of the update filemode in 
order to determine if the update has been applied. 
The update has been found with a filemode other 
than 5 indicating it is not applied. The AUX file 
was then checked and an entry for this update has 
been located indicating the update has been 
previously applied. 


System Action: Processing by the current 
parthandler will end resulting in the PTF not being 
applied. RC=4. 


User Response: Investigate if duplicate updates 
exist that have already been applied, indicated by 
having a filemode 5. If so, the current update can 
be renamed to fm5 or erased. If a duplicate is not 
found then the update should be renamed to fm5S. 
VMFAPPLY can then be used to reapply this PTF 
or it can be applied manually. 


This message may indicate that a PTF has 
incorrectly been unapplied. It also may indicate 
that update files have been received by a part 
handler other than VMFRCUPD. 


1887W The filename EXEC file was not found. 
The {user exit|part handler} filename was 


not executed. 
Explanation: The specified EXEC was not found. 


System Action: The procedure continues without 
executing the EXEC. RC=4. 


User Response: If the EXEC was needed for 
processing, ensure that the EXEC is available to be 
executed, and restart the procedure. 


1888W Product parameter file prodid $PPF has 
been found on filemode filemode. It has 
been renamed to prodid $PPFSAVE 
filemode. A new product parameter file 
will be loaded from the {tapel|envelope}. 
Merge any local changes from the 


renamed file to the new file. 


Explanation: If you had a copy of the product 
parameter file on the target disk for VMFREC, it 
would be overlaid. A copy is saved as filetype 
SPPFSAVE and a new $PPF is loaded down to the 
target disk for VMFREC. 


System Action: The procedure continues with 
RC=4. 


User Response: Merge your changes from the 
$PPFSAVE file into the new product parameter file 
loaded down to the target disk. 


1889E The prodid $PPF product parameter file 
contains invalid data on the ppfta 
record. 7 


Correct the file and retry. 


Explanation: An error has occurred because of 
invalid data contained on the product parameter 
file record indicated by the message text. 


System Action: The procedure exits with RC= 100. 


User Response: Correct the invalid data, and 
restart the procedure. 


1890E The ppfname $PPF product parameter 
file is invalid. record is missing or out of 


order. Correct the file and retry. 


Explanation: A required record cannot be found in 
the product parameter file. 


System Action: The procedure exits with RC = 100. 


User Response: Add the required record, and 
restart the procedure. 


1891E Part handler name failed for component 


compname of product ID prodid. 


Explanation: A part handler EXEC that is listed in 
the product parameter file for the component 
indicated by the message text has failed. 


System Action: The VMFBLD procedure exits 
with RC=100. VMFREC will continue with any 
other prodid components, if the list option was 
specified. 
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User Response: Correct the problem that is causing 
the part-specific EXEC to fail, and retry the 
procedure. 


The name build list was not found in the 
ppfname SPPF file. 


Explanation: A build list name is missing. 


1892E 


System Action: The procedure exits with RC= 100. 
User Response: Add a build list name to the PPF. 


1893E The name tag found in apparent S$PPF 


override file ppfname. 


Explanation: A tag was found in a $PPF override 
file that was not expected. The most likely 
possibility is that it is a COMPLST tag. 


System Action: The procedure exits with RC = 24. 


User Response: Correct the $PPF file and restart 
the procedure. 


1894W Ensure that all parts of prodid compname 
have been received before proceeding to 


the APPLY step. 


Explanation: In order to do a complete APPLY, it 
is necessary that the entire component be received. 
This message is issued if part of the component has 
not been received during this invocation of 
VMFREC. 


System Action: The procedure continues, but will 
exit with RC=4. | 


User Response: Receive the rest of the component, 
if you have not already done so. 


1895E name! tag found {before|after name2 tag 


in ppfname $PPF product parameter file. 


Explanation: A tag was not in the proper place in 
the $PPF file. 


System Action: The procedure exits with RC = 100. 


User Response: Correct the $PPF and restart the 
procedure. 
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1896E The component name is missing from the 


component override tag name. 


Explanation: An override was specified, but no 
base component was listed in the override $PPF 
file. 


System Action: The procedure exits with RC= 100. 


User Response: Correct the $PPF file, and restart 
the procedure. 


1897E Error reading file filename filetype 
filemode. 
or 


A problem occurred reading file filename 
filetype while function function was 
executing. 


Explanation: A file required by the procedure 
cannot be read. 


System Action: The procedure exits with RC= 100. 


User Response: Correct the problem with the file 
and retry the procedure. Some possible problems 
may be: not enough storage, or bad file pointers. 


A record can not be written to file 
filename filetype filemode. 


1898E 


Explanation: A problem has been encountered in 
trying to add a record to a file. 


System Action: The procedure exits with RC= 100. 


User Response: Correct the problem with the 
minidisk and retry the procedure. The most likely 
cause of this problem is that the minidisk is full. 


1899E 


Explanation: A problem has been encountered 
writing a file. 


System Action: The procedure exits with RC = 100. 


There is a problem loading a file. 


User Response: Correct the problem with the 
minidisk and retry the procedure. The most likely 
cause of this problem is that the minidisk is full. 


1900W The existing ppfname $SETUP Al1 file 
has been refreshed. You might want to 


check your access order when done. 


Explanation: VMFSETUP has been invoked for 
accessing two consecutive times, without being 
invoked with the RESTORE option. The first 
access order has been lost. 


System Action: The procedure continues with 
RC=4, 


User Response: Check your access order at the 
completion of processing. 


VMESETUP, when invoked with the 
PPFTEMP parameter, expects a 
temporary product parameter file. 
ppfname $PPFTEMP was not found. 


Explanation: VMFSETUP was invoked with the 
PPFTEMP operand. This operand is only to be 
used if VMFOVER has been invoked previously to 
create a $PPFTEMP file. Because no $PPFTEMP 
file was found, VMFOVER could not have run 
successfully. 


ISO1E 


System Action: The procedure exits with RC =28. 


User Response: Invoke VMFOVER before 
executing VMFSETUP, or invoke VMFSETUP 
without the PPFTEMP operand. 


1902E The compname component name was not 


found in the ppfname SPPFTEMP file. 


Explanation: The $PPF file does not contain a 
section for the specified component. 


System Action: The procedure exits with RC= 100. 


User Response: Correct the $PPF file, and restart 
the procedure. 


The current access order does not match 
the access order that is in the RELEASE 
section of ppfname SSETUP. Your 
access order will be left as it is. 


Explanation: VMFSETUP cannot restore the 
original access order, because the current access 
order is not the same as the one set up by 
VMFSETUP when it was originally invoked. 


1904E 


System Action: The current access order is left 
untouched, and the procedure exits with RC= 100. 


User Response: Check your access order. 


1905W The access of vdev failed with a return 
code of rc. Processing continues for 


product prodid. 


Explanation: VMFSETUP was not able to perform 
an access that was listed in the $PPF file. The 
minidisk may not have been linked or formatted. 


System Action: The procedure continues with 
RC=4. 


User Response: Ensure that the access was not 
needed. If it was needed, you should make the 
minidisk accessible, and restart the procedure. 


1906E The access of vdev failed with a return 
code of rc. Processing stops for product 
prodid. [The original access order 
cannot be restored. | 


Explanation: VMFSETUP was not able to perform 
an access that was listed in the $PPF file. The 
minidisk might not have been linked or formatted. 
It has been determined that this minidisk might be 
essential for processing. 


System Action: The procedure exits with RC = 100. 


User Response: Take whatever steps are needed to 
allow the minidisk to be accessed, and restart the 
procedure. 


19071 Assembling filename [(options)]. 


Explanation: The assembly is going to begin. If 
you specified any assembler options, the options 
used are displayed. 


System Action: The assembly begins. 


User Response: None. 


1908E 


Explanation: If assembling is taking place, an 
assembler error occurred. If updating is taking 
place, a severe update error occurred. 


Error {assembling|updating} filename. 


System Action: Execution is terminated. 


User Response: Correct the error and rerun. 
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1909] filename filetype A [has not been] 
created. 


Explanation: A text file with the given filename 
and filetype has been created, or the text file was 
not produced because of assembler errors. 


System Action: None. 
User Response: None. 


Invalid CSECT name csect-name for ICS 
card in filename filetype. 


1911E 


Explanation: The include control section card has 
an invalid CSECT name specified. 


System Action: The procedure exits. 


User Response: Correct the ICS card, and restart 
the procedure. 


1912E VER card missing in filename filetype. 


Explanation: A VER card was missing, and the 
patch cannot be performed. 


System Action: The procedure exits with RC=100. 


User Response: Add a VER card, and restart the 
procedure. 


1932E Part-handler execname for build list 
listname was found in the filename $PPF 


but a target was not specified. 


Explanation: The name of the target string for the 
specified part-handler and build list in the BLD 
section of the S$PPF file is missing. 


System Action: The procedure ends with RC=100. 


User Response: Correct the $PPF file and reenter 
the command. 


19371 Merge processing has started for 
filename! filename2. 


Explanation: The merge tag in the product 
parameter file contains at least one set of disk 
Strings. It has been determined that the component 
being received has not been previously received and 
that at least one of the first disks of the disk strings 
were not empty. 
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System Action: The procedure continues with the 
merge of the disk strings. For each symbolic disk 
string listed on the merge tag, the contents of each 
disk is moved to the next, starting with the last pair 
in the symbolic disk string. 


User Response: No response required. 


19381 The merge of symbolic-disk-string-name - 
dskI to dsk2 is complete. 


Explanation: As part of merge processing, files 
from each disk listed in a symbolic disk string are 
moved to the next disk starting with the last pair of 
disks. The contents of dsk/ have been successfully 
copied to dsk2 as a result of processing the 
symbolic disk string indicated in the message. 


System Action; The procedure continues merging 
with the next pair of disks in the symbolic disk 
string. If no other pairs exist then if more symbolic 
disk strings exist on the merge tag, they are 
processed. Otherwise merge is complete. 


User Response: No response required. 


19391 Merge processing is complete for 
component compname. 


Explanation: As part of merge processing, files 
from each disk listed in a symbolic disk string are 
moved to the next disk starting with the last pair of 
disks. This process is repeated for each symbolic 
disk string listed on the merge tag in the product 
parameter file. This message indicates that all 
symbolic disk strings have been merged. 


System Action: The procedure continues receiving 
service for the component specified. 


User Response: No response required. 


1940] Merge processing is not required for 
component compname. 


Explanation: The first disk of each symbolic disk 
string listed on the merge tag in the product 
parameter file has been found to be empty, making 
a merge unnecessary. 


System Action: The procedure continues receiving 
service for the component specified. 


User Response: No response required. 


1941E Component compname has already been 
received successfully from PUT|COR 


tape-identifier. 


Explanation: When a tape has successfully been 
received a merge indicator file is written to the first 
disk of each symbolic disk string listed on the 
merge tag in the product parameter file. This 
merge indicator has a filename of PUT or COR 
depending on tape type and a filetype of “SMR” 
concatenated to the first letter of the tape type - P 
or C, concatenated with the tape identifier. 
Another indicator file with a filename of “$” 
concatenated with the tape type and a filetype of 
the tape identifier is created with the comment in 
the COR or PUT DOCUMENT which contains a 
date and time stamp. The tape identifier from the 
“3MR” file is compared to the tape type currently 
being received. If both of these are identical then 
the comment in the second indicator file is 
compared with the comment from the current COR 
or PUT DOCUMENT. If both of these comments 
are identical then this message is issued. 


System Action: The procedure exits with 
RC= 100. 


User Response: This message indicates that the 
service from this tape has already been successfully 
received. Check that the correct tape has been 
mounted. Also verify that the correct component 
has been entered. If the real intent is to re-receive 
service for this component then the indicator files 
described above can be renamed or erased so that it 
appears a receive has not been completed. 


19421 Service has been received for partname 
parttype. It is a part of the serviceability 
enhancements. 


Explanation: A Serviceability Enhancement part 
has received service. This service includes a new 
executable version for partname. 


System Action: The procedure continues. 


User Response: The executable part shipped for 
partname may be at a lower service level than your 
existing partname. Review the self-documenting 
information at the end of EXECs, XEDIT macros, 
and modules to determine the service levels of the 
new and existing parts. If necessary update the 
executable version used on your system to the latest 
level. Copy the PTF numbered version of the part 
to the executable version. 


Example: 


COPY VMFAPCOM EXC12345 B VMFAPCOM EXEC B 


One or more AUX files have been 
received for manually supported parts. 
The AUX files for these parts must be 
evaluated and may need updating to 
assure the validity of your system. 


Explanation: The AUX files that have been 
received contain AUX entries for all updates to the 
part being serviced from the base level of the 
product to the update that was received. Some of 
the AUX entries in the new AUX file may already 
appear in other AUX files on your system. Having 
the same AUX entry appear more than once on 
your system can affect your system’s integrity. 


1943W 


System Action: The procedure continues with 
RC=4. 


User Response: 


¢ Using the SVMFREC $HISTORY file that was 
created during execution of VMFREC EXEC, 
make a list of all of the AUX files that were 
received. The $VMFREC SHISTORY contains 
entries from all runs of VMFREC EXEC. The 
entries from the latest run are on the bottom 
and are outlined with beginning and ending 
time stamps. 


e For each AUX file received, use the LISTFILE 
command to make a list of all of the existing 
AUX files for this part. 


¢ Use XEDIT to view CNTRL file that is used 
for the given part. 


¢ Identify the appropriate AUX level in the 
CNTRL file for the given part. For example, if 
you received corrective service and there is an 
AUXCOR level in the CNTRL file, then this 
would be the appropriate level for the new 
AUX file. 


e If necessary, rename the new AUX file so that 
its filetype matches the appropriate AUX level 
in the CNTRL file. 


¢ Compare the AUX entries in each AUX file 
level that is below the new AUX file level with 
the AUX entries in the new AUX file. For any 
duplicate entries, use an asterisk (*) to 
comment them out of the new AUX file. 


¢ Compare the AUX entries in the old AUX file 
at the same level as the new AUX file with the 
new AUX file. If the old AUX file at this level 
- contains more AUX entries, erase the new one 
or you will down level your system. 
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¢ Compare the AUX entries in each AUX file 
level that is above the new AUX file level. For 
any duplicate entries, use an asterisk (*) to 
comment them out of the higher level AUX 
files. If there are any Local Modifications or 
Local Text Patches, you must determine if they 
intersect with the new update and rework them 
if necessary. 


1944E Update file filename! filetypel filemodel 
contains an unsupported statement type 


type for the patch facility. 


Explanation: The update file identified in the 
message is a patch update which contains a 
statement other than NAME (Name for CSECT), 
ICS (Included control section), VER (verify), REP 
(replace) or comments. Only these statement types 
are allowed in patch update files. 


System Action: The procedure continues with 
RC=100. Invalid cards are not included in the text 
deck. 


User Response: While creating the update file, you 
may have incorrectly typed the update statements. 
If so, correct the statements and retry the 
procedure. Incorrect update files can generate a bad 
nucleus, therefore the update file should be 
corrected. 


1946E The com command failed with a return 
code rc. The input file specification was 
filename] filetypel filemodel. The 
output file specification was filename2 


filetype2 filemode2. 


Explanation: The given CMS command 
experienced a severe error. If there is no input 
specification associated with the command, this part 
of the message is omitted. The same is true for the 
output specification. 


System Action: The procedure continues with 
RC= 100. 


User Response: See the given CMS command for 
more information. 


$96 Installation and Service 


A 3 character abbreviation could not be 
found for the filetype filetype in the 
sAPP. section of prodid prodidft. 


Explanation: Entries in the :APP. section of a 
$PPF (product parameter file) have filetypes and 
filetype abbreviations with which to rename the file 
that is being processed. If a file is being processed 
and its filetype abbreviation cannot be found, it 1s 
an error condition. 


1947E 


System Action: The procedure continues with 
RC= 100. 


User Response: Verify that you are using the 
correct level of the PPF and that it contains the 
required abbreviation in the :APP. section of the 
component that you are servicing. 


1948W AUX file filename filetype on cuu must 
be renamed by its filetype abbreviation 
and a PTF number, but it does not 
contain a PTF number. It is being 


renamed to filename filetype2. 


Explanation: AUX files that are supplied on 
service tapes have filetypes that may be listed in a 
control file. To avoid the new AUX file from being 
picked up and possibly conflicting with your system 
it must be renamed. The new filetype is the 
3-character abbreviation for the AUX file which is 
found in the product parameter file (PPF) 
concatenated with the PTF number found in the 
top AUX entry in the AUX file. Since the AUX 
file does not contain any valid PTF numbers, the 
new filetype will be only the 3-character 
abbreviation. 


System Action: The procedure continues with 
RC=4. 


User Response: None. 


1949W PTF ptfnum for product prodid has 


already been applied. 


Explanation: A PTF was included in the apply list 
that had already been successfully applied. This 
determination was made by looking at the filemode 
of the SPTFPART file for this PTF. A filemode of 
5 indicates that the PTF has been completely 
applied. 


System Action: The procedure continues with 
RC=0. 


User Response: None. 


——- ase ew oe ee te 


1953W filename was interrupted the last time it 
was run. filename SERRLOG has been 


restored from the saved history file 
filename SOLDLOG. 


Explanation: A copy of the SERRLOG named 
$VMFREC, $VMFAPP, or $VMFBLD 
$OLDLOG is saved each time VMFREC, 
VMFAPPLY, or VMFBLD is invoked. If for some 
reason the execution of the EXEC is not completed 
(for example, if the user enters “HX” or the system 
abends) the 3VMFxxx S$OLDLOG remains on the 
users’ A-disk. 


Subsequent VMFREC, VMFAPPLY, or VMFBLD 
invocations append the $3VMFxxx $0LDLOG to 
the new $VMFxxx ERRLOG and erase the 
SVMFxxx $OLDLOG. The $VMFxxx $0LDLOG 
will not exist after a complete run of the associated 
EXEC because it is erased, however the user should 
never erase the SVMF xxx $OLDLOG unless they 
do not want this historical exception log 
information. 


System Action: This message has no effect on 
system action. 


User Response: Investigate the previous messages 
to determine if further action is required. 


1959E The keyword ENV has been specified 
without any parameters following the 
keyword. Check the syntax and reenter 


the command. 


Explanation: The keyword ENV has been detected 
on the command line. This keyword requires the 
filename of an envelope file as a parameter and 
optionally a filetype and filemode. The required 
filemode was not found following the keyword. 


System Action: The procedure exits with RC=8. 


User Response: If you are attempting to process an 
envelope file, investigate the file specification of the 
file you want to process and reenter the command 
with the correct filename of the envelope. If you 
were not attempting to process an envelope file, 
reenter the command without the ENV keyword. 


1960E Envelope filename filetype filemode does 
not exist. Verify the file location or 
check the syntax and reenter the 


command. 


Explanation: The keyword ENV has been detected 
on the command line. If you specified an envelope 
filetype and filemode, a valid format envelope with 


the file specification given could not be found. If 
you did not specify a filemode, an envelope with 
the filename and filetype you specified could not be 
located on any accessed disk. If you only specified 
a filename, the default filetype of SERVLINK was 
used as the filetype and a valid envelope could not 
be located on an accessed disk. 


System Action: The procedure exits with RC = 28. 


User Response: In order to process an envelope, 
the file must reside on an accessed disk at the start 
of the procedure. The envelope must also remain 
accessed during the full execution of the procedure. 
This requires that the envelope reside on the A-disk, 
or on a disk whose address is listed on a disk string 
in the product parameter file for the product being 
processed. If the disk is listed in the product 
parameter file, it must still be accessed at the start 
of the procedure. Verify the name and location of 
the envelope file you are attempting to process. 
Make sure that the disk access conditions described 
above are met. Reenter the command using the 
correct file specification with the envelope in the 
access order. 


1961W The Service Enhancement parts have 
been received from the {tapejenvelope} 
header files but they have NOT been 


activated. 


Explanation; VMFREC has received the service 
execs from the first two tape or envelope files but 
due to a detected inconsistency they have not been 
renamed to their executable forms. 


System Action: RC=4. 


User Response: Examine other messages issued to 
determine the nature of the inconsistency, correct it 
and reissue VMFREC INFO. 


No PTF numbered Service Enhancement 
parts were found in the {tape|envelope} 
header files. 


Explanation: VMFREC has determined that no 
Service Enhancement EXECs or related parts exist 
as PTF-numbered files in tape or envelope files one 
or two. 


1962W 


‘ 


System Action: RC=4. 


User Response: If PTF-numbered service EXECs 
were expected to be on the tape or in the envelope 
determine why they are missing. If the tape or 
envelope was created prior to having 
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PTF-numbered service enhancement parts in the 
header files then no action is required. 


19631 Level nnnn of the Service Enhancement 
parts is now established on mode cuu. 


Explanation: VMFREC has loaded the indicated 
level of the service EXECs onto the reported disk 
and renamed them so that they are executable. 


System Action: RC=0. 


User Response: None. 


1964E The update of the Service Enhancements 
part set inventory file SLEVEL EXEC 
was unsuccessful. 


Explanation: VMFREC was unable to write the 
$LEVEL EXEC file to disk while creating or 
updating it. This file contains a list of the service 
EXECs and associated parts that have been 
installed on the users system. 


System Action: _RC=100. 


User Response: Ensure that the target disk [A|C] 
is writable and rerun VMFREC INFO. 


1965E The name command has failed with 
Return Code rc while operating upon file 
filename filetype filemode cuu execution 
is terminated. 


Explanation: The program was unable to execute 
the reported CMS command while operating on a 
CMS file. 


System Action; RC= 100. 


User Response: Use the reported command name, 
return code and file specified to determine the 
appropriate action to take. 


19661 The filename filetype filmode (cuu) file 
saved as: filename filetype filemode 
(cuu). 


Explanation: VMFREC has saved the existing 
service EXECs and associated parts prior to 
receiving a new version of these files. 


System Action: RC=0. 
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User Response: None. 


19671 The Service Enhancements part set [on 
DISK mode (cuu) | in the 
{tapejenvelope} header files] is at the 
nnnn level. 


Explanation: The level of the service EXECs and 
associated parts that is on the user’s system is 
always reported. The level is extracted from the 
$LEVEL EXEC file. The service execs and 
associated parts are assumed to reside on the same 
disk as the $LEVEL EXEC file, and are also 
assumed to be at the level indicated in the $LEVEL 
EXEC file. 


The level of the service EXECs and associated parts 
on the service tape or in the envelope is reported if 
it differs from the level the user has installed. 


System Action: _RC=0. 


User Response: If the reported level differs from 
what is expected, determine why before proceeding. 
When the level on the tape or in the envelope is 
more current than the level on disk, examine the 
documentation supplied with the tape or envelope 
to determine if the new EXECs should be received 
via VMFREC INFO. 


1968W The Service Enhancements part set on 


DISK is at an UNKNOWN level 
or 


The Service Enhancements part set in the 
{tape|envelope} header files is at an 
UNKNOWN level. 


Explanation: Either VMFREC was unable to 
determine the level of the service EXECs on the 
user’s system because it could not find a $LEVEL 
EXEC file, or VMFREC was unable to determine 
the level of the service EXECs on the service tape 
or envelope even though it contains some service 
enhancements parts in files one and two of the tape 
or envelope. 


System Action: RC=4. 


User Response: Determine why VMFREC is 
unable to find the SLEVEL EXEC file. Reestablish 
it manually or by running VMFREC INFO. 

If the tape level is unknown, request a new service 
tape from IBM. 


The Service Enhancements part set in the 
tape header files, specified by SLEVEL 
$STAPE, conflicts with the tape inventory 
file SLEVEL MAP. 


Explanation: VMFREC has found an 
inconsistency between the tape’s inventory of 
service exec parts and the actual parts in tape files 
one and two. The tape is in error. 


System Action: RC=4. 


1969W 


User Response: Request a new service tape from 
IBM. | 


1970W Entry for PTF pifno, cannot be found in 


any AUX file for filename. 


Explanation: VMFAPPLY is processing a list of 
all AUX file entries for the part identified in the 
message. 


VMFAPPLY is attempting to verify that the PTF 
which contains service for this part exists in that list 
of AUX file entries but it cannot be found. (The 
PTF number would be in the third token of this list 
of AUX file entries.) 


System Action: Processing continues. 


User Response: This PTF is listed in the 
S$APPLIST (apply list) but 1s not part of any AUX 
file for this part on your system. An AUX file on 
your system may be in error or the $APPLIST you 
are using may be in error. An AUX file could be in 
error because IBM shipped you an incorrect AUX 
file or you may have modified an AUX file that 
was sent to you from IBM. 


Contact your IBM service representative for 
assistance. 


1972W The service tape part inventory file 
$LEVEL MAP, is missing from the 


{tape|envelope}. 


Explanation: VMFREC is unable to find a 
$LEVEL MAP file in tape file 1 of the service tape 
or envelope. Either the tape or envelope is in the 
old format or it is in error. 


System Action: RC=4. 


User Response: If the tape or envelope was 
expected to have PTF numbered service parts in 
files one and two then order a new service tape or 
envelope. 


1973W The service {tape|envelope} may be in the 
old format. Using INFO (ALL may 


back level your Service EXECs). 


Explanation: VMFREC has determined that the 
service tape or envelope may be in the old format 
and using the VMFREC INFO (ALL command 
may receive back level executable parts onto your 
disk. 


System Action: RC=4. 


User Response: Do not use VMFREC INFO (ALL 
unless you know it will not destroy your production 
service EXECs. 


1974] A $PPF file for product prodid exists on 
this {tape|disk} volume but is not 
installed on your system. It must be 
received prior to servicing that product. 


Explanation: VMFREC has checked the SPPF files 
in tape file two of the service tape or envelope and 
has determined that a $PPF file exists on the tape 
or envelope that is not listed in the $LEVEL EXEC 
file. 


System Action: RC=0. 


User Response: Before servicing the indicated 
product ensure that its new $PPF has been installed 
on your system. 


An UNKNOWN level of the Service 
Enhancement parts are now established 
on mode cuu. 


Explanation: VMFREC INFO (ALL was used in a 
situation that prevents VMFREC from knowing the 
level of the service EXECs and other parts received 
from files 1 and 2 of the service tape. 


System Action: RC=4. 


1975W 


User Response: Before performing additional 
service, ensure that the new service EXECs are 
those you wish to have installed. 


Appendix J. Messages 899 


Summary of Changes 


Fourth Edition 


Form of Publication: SC23-0364-3 
Level of Product: VM/XA System Product Release 2.1 
Date of Publication: June 1990 


Changes to this publication: 
¢ New device support 


VM/XA System Product Release 2.1 supports the 3390-1 and 3390-2 DASD devices. The 3390 Starter System can 
be used with a 3390-1 and 3390-2. New sample directories and minidisk maps for both of the 3390 models have 
been added to Appendix C, “VM/XA System Product Starter System Information.” 


e Single-level AUX 
Single-level AUX fulfills three customer requirements: 


— The AUX structure has been significantly simplified 
— The LOCAL string is no longer used for nonlocal service 
— The need to reconcile your VM/SUP reach-ahead and COR service when installing a PUT has been removed 


You can still use the multiple AUX file scheme if you choose to. 
e ServiceLink 


ServiceLink is a part of IBMLink that lets you access IBM software service information online. You must be 
authorized to use IBMLink and ServiceLink. In addition, you must be authorized to order service and receive it 
electronically using ServiceLink. 


The ServiceLink information in this manual is intended to help you use the VM support that allows you to receive 
service through a disk file, in addition to the conventional tape medium. 


¢ Receiving multiple COR tapes 


A procedure has been added to allow you to receive multiple COR tapes before running VMFAPPLY. To use this 
procedure, you need to have APARs VM40518 and VM41018 installed on your system. You will find this 
procedure in the following chapters: 


— Chapter 10, “Receiving Service for CMS” on page 417 
— Chapter 11, “Receiving Service for CP” on page 423 
— Chapter 16, “Service to DV” on page 507 
— Chapter 17, “Service to GCS” on page 517 

¢ APAR VM37518 


The information supporting APAR VM37518, contained in VM/XA SP Serviceability Enhancements Program 
Update Information APAR VM37518, GC23-0503-0, has been included in this edition. Support provided by APAR 
37518 includes: 


— Additional parts support provided by part handlers VMFRCAUX and VMFAPAUX. 
— An exception log viewing tool called VMFVIEW EXEC. 

— A reduction in the number of on-screen messages from VMFAPPLY EXEC. 

— A TASK minidisk string, accessed after the A-disk and before the component database. 
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— Read/only minidisk specification in the product parameter file. 


— Acheck for the existence of $PTFPART lists and PTF-numbered parts on the database by part handlers 
VMFRCCOM and VMFRCUPP, so that these parts are not reloaded if they already exist. 


— Inprovements in VMFAPPLY performance using filemode 5 on the PTF parts list to indicate that the PTF has 
been succesfully applied. Additional control over this process is given in the product parameter file by the 
CHKUPD tag. 

° Procedure changes. 


Many of the procedure steps in the installation and service parts of this manual have been re-written to improve 
usability. 
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A 


APAR. Authorized program analysis report. 


authorized problem analysis report (APAR). (1) A 
report of a specific system problem. (2) The code 
correcting a specific system problem. 


automatic software re-IPL. The process by which the 
control program attempts to restart the system after 
abnormal termination. This process does not involve 
the hardware IPL process. See also virtual= real 
machine recovery. 


C 


CCS. Console communication services. 
CCW. Channel command word. 


channel command word (CCW). A doubleword 
structure that directs an 1/O operation on a device or 
channel and includes pointers to any storage areas 
associated with the operation. One or more CCWs 
make up a channel program. 


circumventive fix. A fix that branches around the code 
in error, or avoids executing that code in some other 
way, rather than correcting the error. A circumventive 
fix is temporary. 


CMS. Conversational monitor system. 


control program (CP). The component of VM/XA SP 
that manages the resources of a single 
System/370-Extended Architecture system so that 
multiple computing systems appear to exist. Each 
virtual machine is the functional equivalent of either a 
System/370 computing system or a 
System/370-Extended Architecture computing system. 


console communication services (CCS). A group of CP 
routines that interface with the VTAM service machine, 
providing full VM/XA SP console capabilities for 
SNA/CCS terminal users. 


conversational monitor system (CMS). The component 
of VM/XA SP that, as a virtual machine operating 
system, provides interactive time-sharing. CMS allows 
users to communicate with the system and with each 
other, to create and edit files, and to develop and run 
application programs. It operates in either System/370 
mode or 370-XA mode under the control of CP. 


COR. Corrective service tape. 
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COR-closed PTF. A PTF that is available on a 
corrective service tape. 


CP. Control program. 


corrective service. Service sent to you by IBM to 
correct a specific problem, supplied on a corrective 
service tape in the same format as a program update 
tape. 


corrective service tape (COR). A tape containing 
customized corrective service, sent to you by IBM. 


D 


DCSS. Discontiguous saved segment. 


directory. A CP disk file that includes an entry for each 
user in the system. The entry defines the characteristics 
of the user’s initial virtual machine configuration. These 
characteristics include the user ID, the password, 
normal and maximum allowable virtual storage, virtual 
device definitions, the privilege class, the dispatching 
priority, logical line editing characters, and the account 
number. 


discontiguous saved segment (DCSS). A saved segment 
that occupies one or more architecturally-defined 
segments. It begins and ends on segment boundaries. It 
is accessed by its own name. Contrast with member 
saved segment. See also saved segment, segment, and 
segment space. 


disk string. See string. 


dump viewing facility. A VM/XA SP component that 
allows users to display, format, and print data 
interactively from CP hard and soft abend, stand-alone, 
and virtual machine dumps, and.to process CP trace 
table data stored on tape or in a system trace file. 


dynamic paging area. The area of real storage allocated 
by CP for V=V machine paging. This area also 
contains CP nonresident modules, CP control blocks, 
CP trace tables, free storage pages, and the alternate 
processor’s prefix storage areas. 


E 


Expanded Storage. Optional integrated high-speed 
storage. In VM/XA SP, Expanded Storage may be 
shared by CP and one or more virtual machines. It may 
also be dedicated to CP or to a particular virtual 
machine. 
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F 


full-pack minidisk. A virtual disk that contains all of 
the addressable cylinders of a real DASD volume. 


full-screen mode. In VM/XA SP, the environment in 
which an entire 3270 display screen is under the control 
of a program running in a virtual machine. 


G 


GCS. group control system 


group control system (GCS). The component of 
VM/XA SP that, as a virtual machine supervisor, 
executes in a group of System/370 virtual machines 
under CP control to provide an interface that helps 
support a native Systems Network Architecture (SNA) 
network. 


guest. An operating system running in a virtual 
machine managed by the VM/XA SP control program. 
Contrast with host. 


guest real storage. The storage that appears real to the 
operating system running in a virtual machine. Contrast 
with guest virtual storage, host real storage, and host 
virtual storage. 


guest virtual storage. The storage that appears virtual 
to the operating system running in a virtual machine. 
Contrast with guest real storage, host real storage, and 
host virtual storage. 


H 


host. The VM/XA SP control program in its capacity 
as manager of a virtual machine in which another 
operating system is running. Contrast with guest. 


host real storage. The storage that appears real to the 
control program. If VM/XA SP is running native, this 
is real storage; if VM/XA SP is running in a virtual 
machine, this is virtual storage. Contrast with guest real 
storage, guest virtual storage, and host virtual storage. 


host virtual storage. The storage that appears virtual to 
the control program. Contrast with guest real storage, 
guest virtual storage, and host real storage. 


image library. A set of modules, contained in a system 
data file, that define the spacing, characters, and copy 
modification data that a 3800 printer uses to print a 
spool file or that define the spacing and character set 
that an impact printer uses to print a spool file. See 
also system data file. 


inter-user communication vehicle (IUCV). A generalized 
CP interface that facilitates the transfer of data among 
virtual machines. 


IUCV. Inter-user communication vehicle. 


L 


local service. Any service not supplied on a PUT or 
COR tape. It can be service that you originate, or 
service that is sent to you by IBM to correct or 
circumvent a specific problem that you have 
encountered and reported. Local service can be 
supplied on a tape, in hard copy, or over the phone. 


member saved segment. A saved segment that begins 
and ends on a page boundary. It belongs to from | to 
64 segment spaces and is accessed either by the segment 
space name or its own name. Contrast with 
discontiguous saved segment. See also saved segment, 
segment, and segment space. 


message repository file. A type of system data file that 
contains a set of VM/XA SP messages translated into a 
national language. 


minidisk string. See string. 


missing interrupt handler. A CP function for detecting 
and dealing with real I/O operations that do not 
complete within a specified time. 


multiple preferred guests. A VM/XA SP facility that 
supports up to six preferred virtual machines when the 
Processor Resource/Systems Manager* (PR/SM* feature 
is installed in the real machine. See also preferred 
virtual machine. 


Processor Resource/Systems Manager and PR/SM are trademarks of the IBM Corporation. 
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named saved system (NSS). A copy of an operating 
system that a user has named and retained in a system 
data file. The user can load the operating system by its 
name, which is more efficient than loading it by device 
number. See also discontiguous saved segment, member 
saved segment, saved segment, segment space, and system 
data file. : 


NSS. Named saved system. 


O 


object-maintained code. Code serviced by replacement 
of a complete part. See also replacement service, and 
source-maintained code. 


P 


pageable virtual machine. Synonymous with 
virtual = virtual machine. 


preferred virtual machine. A virtual machine that runs 
in the V=R area. CP gives this virtual machine 
preferred treatment in the areas of performance, 
processor assignment, and I/O interrupt handling. See 
also multiple preferred guests, virtual = fixed machine, 
virtual= real area, and virtual=real machine. 


preventive service. Program update service. 


Processor Resource/Systems Manager (PR/SM). A 
separately orderable feature available with 3090E 
processors that provides for logical partitioning of the 
rea] machine and support of multiple preferred guests. 
See also multiple preferred guests. 


PR/SM. Processor Resource/Systems Manager. 


program temporary fix (PTF). A package of one or 
more APARs. 


program update service. Service sent to you on a 
program update tape, also called preventive service. 
Not to be confused with update service. 


program update tape (PUT). A tape containing 
customized service. Each service tape contains 
cumulative service for the customer’s products back to 
the earliest release level of the product still supported. 
PTF. Program temporary fix. 


PUT. Program update tape. 


real system operator. Any user who loads and runs 
VM/XA SP in the real machine. Contrast with virtual 
machine operator. 


remedial service. Service to temporarily correct or 
circumvent a specific problem that you have 
encountered and reported, until a PTF becomes 
available. Remedial service includes corrective service, 
which IBM supplies on a corrective service tape with the 
same format as a program update tape, and local 
service, which IBM supplies in some other format or - 
which you originate yourself. 


replacement service. Service by replacement of the 
entire part that is in error. See also object-maintained 
code, and update service. 


Ss 


saved segment. One or more pages of storage that have 
been named and retained in a system data file. See also 
discontiguous saved segment, member saved segment, 
segment, segment space, and system data file. 


segment. In System/370 architecture, 64 kilobytes of 
storage. In 370-XA architecture, 1 megabyte of storage. 
See also saved segment. 


segment space. A saved segment composed of up to 64 
member saved segments accessed by a single name. A 
segment space occupies one or more 
architecturally-defined segments; it begins and ends on 
segment boundaries. A user with access to a segment 
space has access to all of its members. See also 
discontiguous saved segment, member saved segment, 
saved segment, and segment. 


service tape. Program update tape or corrective service 
tape. 


service virtual machine. A virtual machine that provides 
system services. These services include accounting, 
error recording, monitoring, and those provided by 
supported licensed programs. 


SMSG function. A CP function that allows a virtual 
machine to send a special message to another virtual 
machine programmed to accept and process the 
message. See also special message. 


SNA. Systems Network Architecture 


SNA/CCS terminal. Any terminal accessing VM/XA 
SP that is managed by a VTAM service machine. 


source-maintained code. Code serviced by combining 
updates with the base code. See also object-maintained 


code and update service. 
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special message. A data transmission, made up of 
instructions or commands, sent from one virtual 
machine to another via the SMSG function. A special 
message is processed by the receiving virtual machine 
and does not appear on the receiver’s console. See also 
SMSG function. 


spool file. A collection of data along with CCWs for 
processing on a unit record device. Contrast with 
system data file. 


string. In applying service, a set of minidisks defined in 
the product parameter file for a particular use; for 
example, the BASE2 string, which holds source code, or 
the DELTA string, which holds update files from the 


program update tape. 


SVC 76. In VM/XA SP, a supervisor call instruction 
that records the error incidents encountered by certain 
operating systems running in virtual machines. When a 
virtual machine operating system issues an SVC 76, | 
VM/XA SP translates the virtual storage and I/O device 
addresses to real addresses, records the information on 
the VM/XA SP error recording virtual machine, and 
returns control to the issuing virtual machine. This 
interface bypasses the virtual machine’s own error 
recording routine, and avoids duplicate error recording. 


System/370 mode. A virtual machine operating mode in 
which System/370 functions are simulated. Contrast 
with 370-XA mode. 


system data file. A collection of data associated with a 
particular function. Types of system data files include 
saved segments, NSSs, UCR files, image libraries, 
message repository files, and system trace files. Because 
a system data file contains no CCWs, it cannot be 
processed on a unit record device. Contrast with spool 


file. 
system hold status. A spool file status that prevents a 
file from being printed, punched, or read until the real 


system operator releases it. Contrast with user hold 
status. 


system trace file. A type of system data file that 
contains CP or virtual machine trace data. 


Systems Network Architecture (SNA). The description 
of the logical structure, formats, protocols, and 


operational sequences for transmitting information units 
through, and controlling the configuration of, networks. 


U 


UCR file. User class restructure file. 
unit record device. A reader, a printer, or a punch. 


update service. Service by applying updates to the base 
code (also called source code) that is in error. Not to 
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be confused with program update service. See also 
replacement service, and source-maintained code. 


user class restructure file (UCR file). A type of system 
data file that contains information used to override the 
IBM-defined privilege class structure of CP commands, 
DIAGNOSE instruction codes, and certain CP system 
functions. 


user directory. See directory. 


user hold status. A spool file status that prevents a file 
from being printed, punched, or read until the file 
owner releases it. Contrast with system hold status. 


V 


Vector Facility (VF). A hardware feature that provides 
synchronous instruction processing for high-speed 
manipulation of fixed-point and floating-point data. 


VF. Vector Facility. 
V=F machine. Virtual= fixed machine. 


virtual = fixed machine (V =F machine). A preferred 
virtual machine with a fixed, contiguous area of host 
real storage that does not start at page 0. CP provides 
performance enhancements for this virtual machine. See 
also multiple preferred guests, preferred virtual machine, 
virtual= real area, virtual= real machine, and 

virtual = virtual machine. . 
virtual machine. In VM/XA SP, a functional equivalent 
of either a System/370 computing system or a 
System/370-Extended Architecture computing system. 
Each virtual machine is controlled by an operating 
system. VM/XA SP controls the concurrent execution 
of multiple virtual machines on an actual 
System/370-Extended Architecture system. 


Virtual Machine/Extended Architecture System Product 
(VM/XA SP). An operating system that allows 
multiple IBM System/370 and 370-XA operating 
systems to run simultaneously on a single 370-XA 
processor. The multiple systems may be used for 
production, testing, developing application programs, 
maintenance, and migration. VM/XA SP also provides 
a high-capacity interactive environment. There are four 
components: the control program (CP), the 
conversational monitor system (CMS), the dump 
viewing facility, and the group control system (GCS). 


virtual machine operator. Any user who loads and runs 
an operating system in a virtual machine. Contrast with 
real system operator. 


virtual = real area (V=R area). A fixed, contiguous 
section of real storage, starting at page 0, in which 
preferred virtual machines execute. CP does not page 


this storage. See also preferred virtual machine, 
virtual = fixed machine, and virtual= real machine. 


virtual = real machine (V=R machine). A preferred 
virtual machine with a fixed, contiguous area of host 
real storage that starts at page 0. CP provides 
performance enhancements and an automatic recovery 
facility for this virtual machine. See also multiple 
preferred guests, preferred virtual machine, virtual= real 
area, virtual= real machine recovery, and virtual= virtual 
machine. 


virtual = real machine recovery (V = R machine 
recovery). A CP function that allows the V=R 
machine to resume operation after most CP abnormal 
terminations. When possible, the facility reestablishes 
the V=R machine environment, allowing the operating 
system running in that virtual machine to perform its 
own recovery processes. See also automatic software 
re-IPL. 


virtual = virtual machine (V=V machine). A virtual 
machine that runs in the dynamic paging area. CP 
pages this virtual machine’s guest real storage in and 
out of host real storage. See also dynamic paging area, 
virtual = fixed machine, and virtual= real machine. 


virtual supervisor state. A condition, controlled by a 
virtual machine’s current PSW, during which the control 
program allows the virtual machine to issue 
input/output and other privileged instructions. When 
these instructions are not emulated, the control program 
intercepts these instructions and simulates their 
functions for the virtual machine. 


virtual wait time. The period during which the control 
program suspends the processing of a program while a 
required resource is unavailable. 


VM/XA SP. Virtual Machine/Extended Architecture 
System Product. 


VTAM service machine. A collection of networking 
programs running in a virtual machine that, together 
with the CP console communication services (CCS) 
routines, provide full VM/XA SP console capabilities for 
SNA/CCS terminal users. A VTAM service machine 
contains either (1) VM/VTAM with VSCS running as an 
application under control of GCS, or (2) VM/VCNA 
running as a VTAM application under control of the 
VSE or VS1 operating system. 


V=R area. Virtual=real area. 
V=R machine. Virtual=real machine. 


V=R machine recovery. Virtual=real machine 
recovery. 


V=V machine. Virtual= virtual machine. 


Numerics 
370 mode. Synonym for System/370 mode. 
370-XA mode. A virtual machine operating mode in 


which System/370-Extended Architecture functions are 
simulated. Contrast with System/370 mode. 
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Bibliography 


This bibliography lists the names and order numbers of microfiche and publications on VM/XA System Product. 


VM/XA System Product Microfiche 


You can order microfiche listings that contain code. The order numbers for the microfiche are: 
Order No. Description 

LYC7-0347 VM/XA System Product: CP listings 

LYC7-0348 VM/XA System Product: CMS listings 

LYC7-0349 VM/XA System Product: GCS listings 

LYC7-0350 VM/XA System Product: dump viewing facility listings. 


VM/XA System Product Publications 


The publications are shown in Figure 69 on page 910. You can order them by their individual order numbers, or you 
can order most of them as a group by using a single order number, SBOF-0241. SBOF-0241 provides: 


e All unlicensed publications (order numbers that do not begin with LY) 
¢ Enough three-ring binders to hold the publications 
e Spine and cover inserts for the binders. 


Note that you must order manuals that contain licensed information (manuals with order numbers that begin with LY) 
through your support personnel. Books that contain licensed information are: 


VM/XA System Product: Features Summary, LY27-8058 

VM/XA System Product: Diagnosis Guide, LY27-8056 

VM/XA System Product: CP Diagnosis Reference, LY27-8054 

VM/XA System Product: CMS Diagnosis Reference, LY27-8052 

VM/XA System Product: Group Control System Diagnosis Reference, LY27-8060 
VM/XA System Product: CP Data Areas and Control Blocks, LY27-8053 
VM|XA System Product: CMS Data Areas and Control Blocks, LY27-8051. 


As shown in Figure 69 on page 910, VM/XA SP publications are organized into six categories: 
1. Evaluation and introduction: information on VM/XA SP concepts 


2. Planning, installation, administration, and service: planning your system and performing system installation and 
maintenance 


. Operation and end use: performing system and virtual machine tasks 
. Application programming: information on using programming interfaces 


. Diagnosis: information for understanding of VM/XA SP design and to aid in problem diagnosis 
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. Reference: quick retrieving of library usage information, command language syntax, macro instructions, 
DIAGNOSE codes, and system messages. 
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Evaluation and Introduction: Understanding Basic System Concepts 


The evaluation and introduction publications for VM/XA SP are: 


VM/XA System Product: Licensed Program Specifications, GC23-0366 
Provides information on the warranted functions of VM/XA SP and describes the specified operating environment. 
VM at a Glance: Large Systems, GC23-0360 


Presents an overview of the features of each of the large VM systems: the VM/XA Systems Facility, VM/SP High 
Performance Option, and VM/XA System Product. 


VM/|XA System Product: General Information, GC23-0362 


Provides general and planning information for VM/XA SP. It can help you decide whether VM/XA SP can fill 
your needs. 


VM/XA System Product: Conversion Notebook, $C23-0357. 


Provides migration and compatibility information for customers migrating from VM/SP HPO Release 5 and 
VM/XA SF Release 2. 


Planning, Installation, Service, and Administration: Generating and 
Maintaining the System 


VM/XA System Product: Planning and Administration, GC23-0378 


Presents system planning concepts for VM/XA SP and virtual machine planning concepts for guest operating 
systems. Planning topics include suggestions for defining your real system configuration and building and 
updating your directory. This book discusses running these operating systems under VM/XA SP: MVS/SP, 
MVS/XA, VSE/SP, VM/SP, and VM/SP HPO. 


This book also provides information on how to manage your system. Administration topics include: 


— Setting up virtual machines for accounting, error recording, and CMS batch 
—- Setting up the programmable operator 

— Redefining command privilege classes 

— Defining and managing saved segments and named saved systems 

— Tuning the system 

— Reference information on the VM/XA SP monitor 


VM/XA System Product: Installation and Service, SC23-0364. 


Gives step-by-step procedures for generating VM/XA SP and describes how to apply service updates to your 
system. 


Operations and End Use: Making the System Work for You 
¢ VM/XA System Product: Real System Operation, SC23-0371 


Provides a task-oriented source for real system operations. In step-by-step format it describes the procedures and 
commands used to perform each real system task. 


VM/XA System Product: Virtual Machine Operation, SC23-0377 


Provides a task-oriented source for virtual machine operations. In step- -by-step format it describes o procedures 
and commands used to perform each virtual machine task. 


VM|XA System Product: CMS User's Guide, S$C23-0356 


Provides information on using CMS. 
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VM/XA System Product: CMS Primer, SC23-0368 
Provides a tutorial approach to learning CMS. 
VM/XA System Product: System Product Editor User's Guide, SC23-0373. 


Provides information about using the System Product Editor. 


Application Programming: Using Programming Interfaces 


VM/XA System Product: CP Programming Services, SC23-0370 
Provides reference and usage information for the following CP services and macros: 


— The DIAGNOSE codes 
— The IUCV macro 
— CP system services 


VM/XA System Product: CMS Application Program Development Guide, SC23-0355 


Helps you use the assembler language macros and functions of CMS in your assembler language application 
programs. It describes how to manage storage, perform I/O, handle interrupts, process abends, load and start 
programs, and exploit 31-bit addressing. It also includes message repository information. 


VM/XA System Product: CMS Application Program Conversion Guide, SC23-0403 


‘ Helps you convert your existing CMS assembler language application programs so that they run on the CMS 


provided with VM/XA SP. It summarizes the differences between the CMS provided with VM/XA SP and 
previous versions of CMS, it describes the tasks you may need to perform in converting your programs, and it 
points you towards other books that can help you convert your programs. 


VM/XA System Product: Application Development Guide for FORTRAN and COBOL, SC23-0369 


Provides information on how to use the CMS environment to develop and execute FORTRAN and COBOL 
application programs. The book contains such information as: 


~ How to use the System Product Editor to create an application program 
—- How to load, compile, and execute selected supported licensed programs 


VM/XA System Product: System Product Interpreter User's Guide, SC23-0375. 


Provides information about using the System Product Interpreter. 


Diagnosis: Understanding System Design 
© VM/XA System Product: Diagnosis Guide, LY27-8056 


Provides diagnostic information. It describes how to locate problems within the VM/XA SP control program, 
how to describe and report problems to IBM support personnel. The diagnosis reference publications describe 
how the system works. You should use them as supplements to this book. 


VM/XA System Product: CP Diagnosis Reference, LY27-8054 


and 


Describes each of the major VM/XA SP control program facilities. Also contains a module cross-reference list. 


VM/XA System Product: CMS Diagnosis Reference, LY27-8052 
Describes each of the major conversational monitor system facilities. 
VM/XA System Product: Group Control System Diagnosis Reference, LY27-8060 


Describes step-by-step procedures for identifying problems in each of the major facilities of the group control 
system and lists important GCS control blocks. 
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VM/XA System Product: CP Data Areas and Control Blocks, LY27-8053 

Lists the data areas and control blocks used by the VM/XA SP control program. 

VM/XA System Product: CMS Data Areas and Control Blocks, LY27-8051 

Lists the data areas and control blocks used by CMS. 

VM/XA System Product: Dump Viewing Facility Operation Guide and Reference, SC23-0359. 


Describes step-by-step procedures for using the dump viewing facility. The publication is also a reference for 
dump viewing facility commands and messages. 


Reference: Retrieving Information Quickly 


VM/XA System Product: CP Command Reference, SC23-0358 


Provides complete descriptions of the commands used to communicate with VM/XA SP, including usage notes. 
The commands are in alphabetical order. 


VM/XA System Product: CMS Command Reference, SC23-0354 


Provides complete descriptions of the commands used to communicate with the CMS component of VM/XA SP. 
The commands are in alphabetical order. 


VM/XA System Product: Group Control System Command and Macro Reference, SC23-0433 


Provides complete descriptions of the commands used to communicate with the GCS component of VM/XA SP 
and the macros that can be used in GCS application programs. This book also includes information about writing 
REXX EXECs for use under GCS. 


VM/XA System Product: Features Summary, LY27-8058 


Provides a comprehensive survey of VM/XA SP at a higher level than the VM4/XA SP CP Diagnosis Reference. 
Topics cover such areas as: 


— Supported features, hardware, and operating systems 

— CP-owned direct access storage, CP virtual storage, and real storage organization 
— CP virtual and real machine management 

— CMS, GCS, and the dump viewing facility 

— VM/XA SP performance facilities and installation 


VM/XA System Product: System Messages and Codes Reference, SC23-0376 


Contains the system messages generated by the VM/XA SP CP, CMS, and GCS components. For each message, 
the publication provides: 


— The message number 

— The message text 

~ An explanation of why the message was issued 
— System action 

- Recommended operator action (if any) 

— Recommended user action (if any) 

— Return code (if any) 


The publication also documents all abend codes and wait state codes, as well as the reason for each code and the 
recommended action. 


VM/XA System Product: CMS Application Program Development Reference, SC23-0402 


Describes the CMS programming interface. It includes descriptions of the CMS macros, DOS macros, and 
external-use control blocks. 
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VM/XA System Product: Quick Reference, SX23-0391 


Shows only the command syntax of all the VM/XA SP commands. The commands summarized in this publication 
are described in detail in the VM/XA System Product: CP Command Reference, the VM/XA System Product: CMS 
Command Reference, the VM/XA System Product: Dump Viewing Facility Operation Guide and Reference, and the 
VM/XA System Product: Group Control System Command and Macro Reference. 


VM/XA System Product: System Product Editor Command and Macro Reference, SC23-0372 
Describes the system product editor commands, in alphabetical order. 

VM/XA System Product: System Product Interpreter Reference, SC23-0374 

Describes the system product interpreter statements, in alphabetical order. 

VM/XA SP EXEC 2 Reference, SC23-0361 

Describes the EXEC 2 control words, in alphabetical order. 

VM/XA System Product: Library Guide, Glossary, and Master Index, GC23-0367 


Provides an overview of the library’s structure, a glossary, and a means for directly locating specific information 
within a manual or manuals. 


VM|XA System Product: CMS Primer Summary of Commands, SC23-0421. 
Contains summary information about commands described in the VM/XA System Product: CMS Primer. 
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additional base CP minidisks 
installing 29 
AUTOLOG 191 29, 131 
CMSBATCH 195 29, 131 
DISKACNT 191 29, 131 
EREP 191 29, 131 
MAINT minidisks 29, 131 
OPERATNS 191 29, 131 
RSCS 191 131 
XAMAINT minidisks 227 
ADRP (Auto-Deactivation of Restricted 
Passwords) 583, 859 
allocating 
XAPO001 volume 27, 128, 224 
XAP002 volume 28, 129, 225 
XASERV volume 26, 128, 223 
ALTAMS 
installing test saved segment 460 
ALTBAM 
installing test saved segment after service 457 
ALTDOS 
installing test saved segment after service 457 
alternate GCS nucleus placement 855 
ALTHELP segment 
installing after service 463 
ALTINST segment for System Product Editor and 
EXEC Languages 
installing after service 463 
ALTVSAM 
installing test saved segment 460 
APAR number 
finding corresponding PTF number 867 
apply exception log 
example 380 
apply list 
description 376 
example of 376, 377 
apply lists 
example of 376 
applying 
COR service 
to dump viewing facility 507 
toGCS 517 | 
local service 548 
patch service 557 
program update service 
to dump viewing facility 507 
toGCS 517 
to licensed programs 531 
applying PTFs 376 
ASMGEND EXEC 
building system assembler 576 
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ASMGEND EXEC (continued) 

format 576 

function 576 

messages 576 

usage notes 576 
Assembler H Version 2 

installing 44, 146, 242 
assembling 

DMSNGP profile 150 
assembly errors 

correcting 60, 162, 256 
attaching product tape 

to MAINT 23, 124 

to XAMAINT 220 
auxiliary control files 366 

creating 427, 429, 645 

definition 366 

examples of 366 

updating VM/XA System Product 366 


B 
backing up 
CMS __ 109, 210, 307 
CP 110, 308 
named saved systems 109, 210, 307 
BASE control record 
format 716 
function 716 
options 716 
bibliography 909 
build exception log 
example 381 
building 
CMS nucleus 49, 247, 652 
CP nucleus 652 
GCS nucleus 77, 178, 275, 342, 652 
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card reader | 
defining with starter system 18, 119 
changes to this book 901 
CMS load map 42, 53, 144, 156, 240, 252 
CMS (conversational monitor system) 
ALTINST segment 463 
CMS load map 42, 53, 144, 156, 240, 252 
CMSINST segment 103, 204, 301, 328, 482 
deleting service 559 
generating 4, 49, 151, 247 
generating new module 577 
load list 
definition 382 
restriction 382 
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CMS (conversational monitor system) (continued) 
load map 
description 383 
loading national language files from feature 
tape 314 
modules 
regenerating 444, 567 
named saved systems 
backing up 109, 210, 307 
nucleus 
building 49, 247, 652 


building after loading national language files 320 


load address 40, 238 


printing CMS load map 43, 54, 145, 157, 241, 253 


rebuilding after service 431 
regeneration requirements 567 
system generation 49, 151, 247, 442, 472 
CMSAMS 
installing saved segment 
installing default 98, 199, 296 
reinstalling saved segment after service 
reinstalling default after service 479 
CMSBAM 
function 624 
installing saved segment 
installing default 95, 196, 293 
reinstalling saved segment after service 
reinstalling default after service 476 
SAMGEN EXEC 624 
CMSDOS 
installing saved segment 
installing default 95, 196, 293 
reinstalling saved segment after service 
reinstalling default after service 476 
CMSGEND EXEC 
command format 577 
function 577 
how it works 578 
messages 579 
options 577 
regenerating PROP command 578 
usage notes 578 
CMSINST segment for System Product Editor and 
EXEC Languages 103, 204, 301, 328 
reinstalling after service 482 
CMSVSAM 
installing saved segment 
installing default 98, 199, 296 
reinstalling saved segment after service 
reinstalling default after service 479 
commands 
DIRECTXA 583 
DISKMAP 587 
HCPLDR 590 
ITASK 611 
SPLOAD 627 
UPDATE 631 
UTILITY 642 
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commands (continued) 
VMFLKED 661 
VMFMERGE 668 
VMFNLS_ 672 
VMFPLC_ 679 
VMFPLCD 681 
VMFPLC2 687 
VMFREMOV 697 
ZAP 712 
COMMENT control record 
format 719 
function 719 
configuration 
starter system requirements 725 
control blocks 
CP 853 
control files 
auxiliary 366 
CMS 365 
CMS macros 365 
example of 362 
forCP 364 
for dump viewing facility 365. 
for GCS 365 
for local service 365 
for UTILITY EXEC 364, 365 
for VM/XA SP loader 365 
generating CP 493 
HCPLDR 591 
how used 362 
used in VMFNLS EXEC procedure 672 
varying to generate multiple systems 364 
VMFHASM 657 
VMFMAC 665 
control records 
ZAP service program 712, 713 
BASE 716 
COMMENT 719 
DUMP 713 
END 719 
LOG 718 
NAME 715 
REP 717 
VER or VERIFY 716 
copy file 665 
COR descriptor file 372 
COR document 372 
correcting 
assembly errors 60, 162, 256 
load errors 64, 166, 269 
corrective service 
See also servicing the system 
applying to CMS 427 
applying to CP 429 
applying to dump viewing facility 507 
applying to GCS 517 
deleting 559 
files used 371 
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rebuilding CMS 431 messages 107, 208, 305, 332, 465 
rebuilding CP 487 using to install CMSINST segment 580 
receiving for CMS 417 DDRXA (DASD Dump/Restore Program) 3, 15, 115 
receiving for CP 423 defining 
corrective service tape devices 17 
description 414 devices using starter system 17, 118 
mapping 419, 424, 531 minidisk passwords 71 
CP (control program) deleting 
applying COR service 429 PTFs 559 
applying PUT service 429 service 559 
backing up 110, 308 Device Support Facilities 3 
control blocks 853 loading 13, 114 
data areas 853 devices for system generation 
deleting service 559 defining 17 
generating 4 directory 
generating nucleus 61, 163, 258 See user directory 
hardware initial program load 68, 169, 267 DIRECTXA (CMS command) 
load list command syntax 583 
definition 382 examples 585 
description 382 function 583 
restriction 382 invocation by ITASK EXEC 25, 126, 222 
system generation 493 messages 585 
load map 65, 167, 261, 496 restrictions 584 
description 383 return codes 585 
saving 65, 261, 496 storage requirements 584 
loading national language files from feature system generation 71, 172, 263 
tape 314 usage notes 584 
modules disk maps 
regenerating 501, 573 3350 system residence device 759 
nucleus 3375 system residence device 775 
building 652 3380 system residence device 791 
building after loading national language files 334 3380-E4 system residence device 805 
generating 61, 163, 258 3380-K system residence device 819 
saving IPLable copy on tape 642 3390 system residence device 835 
rebuilding after service 487 3391 system residence device 848 
receiving corrective service 423 DISKMAP EXEC 
receiving program update service 423 example 587 
regeneration requirements 573 format 587 
utilities function 587 
regenerating 501 usage notes 587 
CP-owned DASD display device 
reallocating 265 defining with starter system 19, 121 
creating auxiliary control files 427, 429, 645 DMKRIO ASSEMBLE file 
CTL option converting to HCPRIO ASSEMBLE 254 
of UPDATE command 632 DMKSYS ASSEMBLE file 
converting to HCPSYS ASSEMBLE 254 
D DMSNGP ASSEMBLE file 
assembling 150 
DASD (direct access storage device) loading 25, 222 
CP-owned | prompts 50, 152, 248, 321 
reallocating 265 sample 726 
used by UTILITY EXEC 644 system generation 4 
data areas tailoring 
CP 853 existing system installation procedure 244 
DCSSGEN command Starter System installation procedure (first 
format 580 level) 46 
functions 580 Starter System installation procedure (second 
level) 148 
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documentation 909 
DOSGEN EXEC 
functions 588 
installing ALTDOS 457 
installing CMSDOS 95, 196, 293 
messages 97, 198, 295, 459, 588 
reinstalling CMSDOS after service 476 
DUMP control record 
format 714 
function 713 
options 714 
usage notes 714 
dump utility 
putting on tape or DASD 264 
dump viewing facility 
COR service 507 
deleting service 559 
modules 
regenerating 574 
program update service 507 
regeneration requirements 574 


END control record 
format 719 
function 719 
EREP (Environmental Recording Editing and Printing 
Program) 
installing 74, 175, 272 
error messages 869-899 
errors 
assembly 
correcting 60, 162, 256 
load 
correcting 64, 166, 269 
ESERV utility 
support using CMSBAM 624 
exception logs 
description of 378 
example of 380, 381 
exclude list 
description 377 
example of 377 
excluding PTFs 377 
EXEC procedures 
ASMGEND 576 
CMSGEND 577 
DISKMAP 587 
DOSGEN EXEC 588 
GROUP 589 
installing ALTDOS with DOSGEN 457 
installing ALTVSAM and ALTAMS with 
ALTVSAMG 460 
installing CMSBAM with SAMGEN 98, 198, 296 
installing CMSDOS with DOSGEN 95, 196, 293 
installing CMSVSAM and CMSAMS with 
VSAMGEN 98, 199, 296 
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EXEC procedures (continued) 
INSTFPP 600 
ITASK 126, 611 
loading from product tape 24, 125, 221 
reinstalling CMSBAM with SAMGEN after 
service 459, 478 
reinstalling CMSDOS with DOSGEN after 
service 476 | 
reinstalling CMSVSAM and CMSAMS with 
VSAMGEN after service 479 
SAMGEN 624 
SPLOAD 627 
loading from product tape 24, 125, 221 
UTILITY 642 
VMFAPPLY 645 
VMFBLD 652 
VMFHASM_ 657 
VMFLKED 661 
VMFMAC 665 
VMFMERGE 668 
VMFNLS_ 672 
VMFOVER 677 
VMFREMOV 697 
VMFSETUP 700 
VMFVIEW 702 
VMFZAP 707 
VSEVSAM_ 709 
ZAPTEXT 720 
EXECUPDT EXEC 
using to regenerate CMS EXECs 449, 504, 513 
existing system 
installing VM/XA SP using 215 
shutdown 267 
EXPAND command 
format 722 
function 721 
messages 723 
object deck form 721 
options 722 
EXPAND control record 
format 721 
usage notes 721 


F 


files 
used in COR service 371 
used in program update service 371 
first-level installation 8 
formatting 
minidisks 29, 227 
XAPOOL volume 27, 128, 224 
XAPO002 volume 28, 129, 225 
XASERV volume 26, 128, 223 


G generating 


4 
GCS (group control system) CMS nucleus 9, 247 


accessing other saved segments 11 
alternate nucleus placement 855 
authorized user IDs 10 
building nucleus 77, 178, 275, 342 
common dump receiver 10 
configuration file 589 
authorized user IDs 10 
common dump receiver 10 
maximum virtual machines 11 
planning 10 
recovery machine 10 
saved segments 11 
system disk 10 
system disk extension 10 
system ID 11 
system name 10 
trace table size 11 
COR service 517 
deleting service 559 
description 9 


directory 

planning 9 
installing 

multiple GCS systems 9 
load list 


definition 382 
resctriction 383 
load map 
description 383 
loading national language files from feature 
tape 314 
maximum virtual machines in group 11 
multiple systems 89, 190, 287, 345 
nucleus 
alternate placement 855 
building 652 
building after loading national language files 342 
planning considerations 9 
configuration file 10 
storage requirements 9 
system directory entry 9 
system name table entry 10 
program update service 517 
recovery machine 10 
regeneration requirements 574 
SAMPNSS EXEC entry 
planning 10 
saving 77, 178, 275, 342 
storage requirements 9 
system disk 10 
system disk extension 10 
system ID 11 
system name 10 
trace table 11 


group control system 
See GCS (group control system) 
GROUP EXEC 
creating GCS configuration file . 589 
format 589 
function 589 
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HCPBOX ASSEMBLE file 
tailoring 55, 158, 255 
HCPLDR command 
command syntax 590 
control file 591 
function 590 
load list 590 
loader control statements 
conditional page boundary (CPB) 594 
delete (DEL) 599 
include control section (ICS) 598 
loader termination (LDT) 596 
padding (PAD) 595 
parameter (PRM) 595 
printer (PRT) 593 
replace (REP) 597 
set location counter (SLC) 594 
set page bound (SPB) 593 
subsystem (SYS) 596 
unconditional page boundary (UPB) 593 
verify (VER) 597 
system generation 493 
HCPRIO ASSEMBLE file 
converting DMKRIO 254 
creating fom DMKRIO 254 
loading 25, 222 
sample 727 
system generation 4, 55, 158 
tailoring 55, 158 
HCPSYS ASSEMBLE file 
converting DMKSYS 254 
creating from DMKSYS 254 
loading 25, 222 
sample 
for 3350 745 
for 3375 761 
for 3380 777 
for 3390 821 
system generation 4, 55, 158 
tailoring 55, 158 
HELP facility 
loading national language files from feature 
tape 314 
HELP segment 103, 204, 301, 328 
reinstalling after service 482 
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: 
IBM Software Manufacturing and Distribution 351 
image library 
installing default 75, 176, 273 
impact printer 
image library 
installing default 75, 176, 273 
INC option 
of UPDATE command 632 
installation heading 52, 154, 250, 323 
installation segment 51, 153, 249, 321 
installation tools 
DCSSGEN command 580 
ITASK EXEC 6il 
SPLOAD EXEC 627 
UTILITY EXEC 642 
installing 
Assembler H Version 2 44, 146, 242 
EREP 74, 272 
first level 8 
licensed programs 600 
PTFs 376 
second level 8 
system generation 
tailoring DMSNGP profile 148 
system national language 31] 
build new CMS nucleus 320 
build new CP nucleus 334 
build new GCS nucleus 342 


contents of national language feature tape 312 


create new GCS configuration file 340 
load language files from tape to disk 314 
INSTFPP EXEC 600 
after running 608 
before running 601 
format 600 
messages 609 
panels 604-608 
rerunning 610 
running in panel mode 604 
specifying products directly 608 
introduction 
local service 543 
patch service 555 
IOCP file 
sample 733 
IOCP (Input/Output Configuration Program) 5 
ISMD 351 
ITASK EXEC 
CMS nucleus 49, 151, 247 
format 611 
function 611 
installing additional CP minidisks 29, 131, 227 
ITASK 
invoking 25, 222 
loading from product tape 24, 125, 221 
loading product tape 31, 133, 229 
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ITASK EXEC (continued) 


L 


messages 614 
options 612 
prompt 

for MAINT password 25, 222 

for OPERATOR password 25, 222 
prompt for MAINT password 126 
prompt for OPERATOR password 126 
system generation 5, 25, 46, 49, 126, 148, 151, 222, 

247 

tailoring DMSNGP profile 46, 244 

using the BASEIDS operand 29, 131, 227 


language 


specifying 50, 152, 249, 321 


licensed programs 


building after service 531 
installing 600 
program update service 531 


load errors 


correcting 64, 166, 269 


load list 


definition 382 
description 382 


load map 


CMS 42, 53, 144, 156, 240, 252 

CP 65, 167, 261, 496 

printing 43, 54, 66, 145, 241, 253, 262 
saving 42, 53, 65, 240, 252, 261 


loading 


Device Support Facilities 13, 114 

directory 25, 222 

DMSNGP profile 25, 222 

HCPRIO ASSEMBLE 25, 222 

HCPSYS ASSEMBLE 25, 222 

national language files 314 

product tape 31, 72, 73, 133, 173, 174, 229, 270, 
271 

sample files 25, 126, 222 

Starter system 17 

system generation tools 127 

tape files to disk 687 

user directory 25, 222 


local service 


See.also servicing the system 
applying 548 

control files 365 

deleting 559 

introduction 543 
preparation 544 
rebuilding CMS 431 
rebuilding CP 487 


local terminals 


using for installation 117 


LOG control record 


format 718 


LOG control record -(continued) 
functions 718 
usage notes 718 

logon passwords 


for MAINT and OPERATOR 7, 25, 127, 223 


security 7, 583, 859 


macro library 
VMFLKED 661 
VMFMAC 665 

MAINT virtual machine 
system generation 5 
use in service 352 


MAP file, PRELOAD utility program 623 


mapping 
COR tape 419, 424, 531 
PUT tape 419, 424, 531 
Memo to Users 374 
messages 869—899 
ASMGEND 576 
CMSGEND 579 


DCSSGEN command 107, 208, 305, 332, 465 


DIRECTXA command 585 
DOSGEN 588 
INSTFPP EXEC 609 
ITASK 614 
PRELOAD 623 
PROD LEVEL file 609 
repository 
updating for CMS 438 
updating for CP 491 
updating for GCS 525 
servicing CMS repository 438 
servicing CP repository 491 
servicing GCS repository 525 
SPLOAD 630 
UPDATE command 640, 660 
updating CMS repository 438 
updating CP repository 491 
updating GCS repository 525 
UTILITY 644 
VMFHASM EXEC 660 
VMFLKED 664 
VMFMAC EXEC 667 
VMFMERGE 670 
VMFNLS EXEC 676 
VMFREMOV EXEC 698 


VMFZAP_ 708: 
VSEVSAM_ 710 
migrating 


spool files 266 

minidisk maps 
3350 system residence device 759 
3375 system residence device 775 
3380 system residence device 791 


3380-E4 system residence device 805 


minidisk maps (continued) 


3380-K system residence device 819 


3390 system residence device 835 
3391 system residence device 848 
minidisk passwords 
defining 71 
minidisks 
establishing access order 700 
formatting 29, 227 


minimum hardware configuration 725 


modules 

CMS 
regenerating 444, 567 

CP 
regenerating 501, 573 

dump viewing facility 
regenerating 574 

updating with VMFHASM 657 


N 
NAME control record 
format 715 
function 715 
options 715 
national language 
installing 311 
specifying 50, 152, 249, 321 
national language support 
updating message repository 
for CMS 438 
for CP 491 
for GCS 525 
NOINC option 
of UPDATE command 632 
NOSEQ8 option 
of UPDATE command 631 
NOSTK option 
of UPDATE command 632 
NOSTOR option 
of UPDATE command 633 
nucleus 
building 652 
CP 


saving IPLable copy on tape 642 


O 


override file, product parameter 
description 402 
example 402 


P 


passwords 


for MAINT and OPERATOR 7, 25, 127, 223 


restricted password list 583, 859 
security 7, 583, 859 
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patch facility 616 product tape (continued) 


patch update files format 3 
description 368 loading 31, 72, 73, 133, 173, 174, 229, 270, 271 
PID 351 loading files from 124 
planning program update service 
GCS 9 See also servicing the system 
national languages 11 applying 557 
preferred virtual machine applying to CMS 427 
system generation 58, 161 applying to CP 429 
PRELOAD MODULE applying to dump viewing facility 507 
command format 622 applying to GCS 517 
function 622 applying to licensed programs 531 
input 622 deleting 559 ; 
messages 623 files used 371 
output 623 introduction 555 
reformatting TEXT files 622 rebuilding CMS 431 
PRELOAD utility program rebuilding CP 487 
MAP file 623 receiving 556 
TEXT file 623 receiving for CMS 417 
preparation receiving for CP 423 
local service 544 receiving for licensed programs 531 
preventive service program update tape 
See program update service See PUT (program update tape) 
primary system operator . PTF number 
starter system 21, 122 finding from APAR number 867 
printer PTF parts list 
defining with starter system 17, 119 description 376 
printing PTFs 
CMS load map 43, 54, 145, 241, 253 applying 376 
CP load map 66, 262 applying to SNA products 668 
PROD LEVEL file applying using VMFMERGE 669 
example 609 excluding 377 
update messages 609 installing 376 
product contents directory removing from SNA products 697 
description 373 removing using VMFREMOV 698 
examples 373 publications 909 
product parameter file punch 
copy 677 defining with starter system 17, 119 
description 384 PUT descriptor file 
example 384 description 372 
minidisk access order 700 example 372 
overrides PUT document 372 
in override section of base file 384 PUT (program update tape) 351 
in separate override file 402 description 411 
tags format 411 
in component area 395 mapping 419, 424, 531 
in override area 401 . 
in product area 395 
tailoring 55, 158, 257 R 
temporary copy reader 
description 403 defining with starter system 18 
examples 403 rebuilding 
product parameter override file CMS nucleus 652 
description 402 CP nucleus 652 
example 402 GCS nucleus 652 
product tape receive exception log 
attaching to MAINT 23, 124 description 379 
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receive history log 

description 381 
receiving 

local service 547 

patch service 556 

program update service 

for licensed programs 531 

service files 419, 424, 532 
regenerating 

CMS 567 

CP 573 

dump viewing facility 574 

GCS 574 
REP control record 

example 718 

function 717 

special consideration during ZAP processing 719 

usage notes 718 
restart indicator files 

description 383 
restarting 

installation 123 

VMFREC EXEC 383 
restoring 

starter system to disk 15, 115, 217 
restricted password list 583, 859 
RPWLIST DATA 583, 859 
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SAM (Sequential Access Method) 
support using CMSBAM 624 
SAMGEN EXEC 
functions 624 
installing CMSBAM 98, 198, 296 
reinstalling CMSBAM after service 459, 478 
using to install CMSBAM segment 624 
sample files 
DMSNGP ASSEMBLE 726 
HCPRIO ASSEMBLE sample file 727 
HCPSYS ASSEMBLE 
for 3350 745 
for 3375 761 
for 3380 777 
for 3390 821 
IOCP sample file 733 
loading 25, 126, 222 
messages 626 
product parameter sample file 384 
usage notes 625 
user directory 
for 3350 747 
for 3375 763 
for 3380 779 
for 3380-E4 793 
for 3380-K 807 
for 3390 823 
for 3391 837 


SAMPNSS EXEC 
format 625 
saved segments 
installing ALTDOS and ALTBAM 457 
installing ALTVSAM and ALTAMS 460 
installing CMSDOS and CMSBAM 95, 196, 293 
installing CMSVSAM and CMSSAMS 98, 199, 296 
reinstalling CMSDOS and CMSBAM after 
service 476 
reinstalling CMSVSAM and CMSSAMS after 
service 479° 
saving 
CMS load map 42, 53, 240, 252 
CP load map _ 65, 261 
GCS nucleus 77, 178, 275, 342 
second-level installation 8 
security 
password 7, 583, 859 
self-documenting text decks 
description 375 
SEQ8 option 
of UPDATE command 631 
service files 
description 367 
example of 368, 375, 376, 378, 380, 381 
guidelines 369 
naming conventions 366 
receiving 419, 424, 532 
temporary load list 383 
service level update 414 
service tape 
mapping 419, 424, 531 
servicing the system 590, 631, 657, 661, 665, 702 
applying updates to national language-related files 
using VMFNLS_ 673 
control file 
for CMS 365 
for CMS macros 365 
for CP 364 
for dump viewing facility 365 
for GCS 365 
for HCPLDRCM 365 
for loader 365 
for UTILITY EXEC 365 
control file identifiers 364 
COR descriptor file 372 
COR document 372 
COR service 371 
corrective service 
applying to CMS 427 
applying to CP 429 
deleting 559 
receiving for CMS 417 
receiving for CP 423 
emergency service using patch facility 
applying 557 
introduction 555 
receiving 556 
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servicing the system (continued) 
local service 
applying 548 
deleting 559 
introduction 543 
preparation 544 
receiving 547 
MAINT virtual machine 352 
Memo to Users 374 
product contents directory 373 
program update service 371 
applying to CMS 427 
applying to CP 429 
deleting 559 
receiving for CMS 417 
receiving for CP 423 
PUT descriptor file 372 
PUT document 372 
service level update 414 
service overview 349 
source-maintained products 
files used 361 


tools and EXECS used during the service 


process 358 
UPDATE command 631 
setting 
TOD clock 20 
SNA (System Network Architecture) 
applying PTFs 668, 697 
applying ZAPs 707 
source update files 
description 367 
specifying 
national language 50, 152, 249, 321 
SPLOAD EXEC 
format 627 
function 627 
loading from product tape 24, 125, 221 
messages 630 
system generation 5 
SPLOAD PROFILE 
copy of 627 
loading from product tape 24, 125, 221 
syntax 627 
used by SPLOAD EXEC 627 
spool files 
migrating from VM/SP to VM/XA SP 
SPTAPE command 
using to migrate spool files 266 
stand-alone dump utility 
putting on tape or DASD 264 
starter system 
HCPRIO ASSEMBLE sample file 727 
HCPSYS ASSEMBLE 
for 3350 745 
for 3375 761 
for 3380 777 
for 3390 821 
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starter system (continued) 
IOCP sample file 733 
loading 17, 118 
minimum hardware configuration 725 
restoring to disk 15, 115, 217 
shutdown 68, 169 


system residence DASD allocation for 3350 758 
system residence DASD allocation for 3375 774 
system residence DASD allocation for 3380 790 
system residence DASD allocation for 3380-E4 804 
system residence DASD allocation for 3380-K 818 
system residence DASD allocation for 3390 834 


system residence DASD allocation for 3391 


user directory 
for 3350 747 
for 3375 763 
for 3380 779 
for 3380-E4 793 
for 3380-K 807 
for 3390 823 
for 3391 837 
using to define devices 17, 118 
starter system tape 
format 3 
starter system worksheet 7 
STK option 
of UPDATE command 632 
stopping and restarting installation 123 
STOR option 
of UPDATE command 633. 
summary of changes to this book 901 
SYSCPVOL, HCPSYS macro instruction 
system generation 59, 161 
SYSID, HCPSYS macro instruction 
system generation 59, 161 
SYSRES, HCPSYS macro instruction 
system generation 58, 161 
SYSSTORE, HCPSYS macro instruction 
system generation 58, i161 
system assembler, building 576 
system generation 
Assembler H Version 2 44, 146, 242 
backing up 
CMS _ 109, 210, 307 
CP 110, 211, 308 
named saved systems 109, 210, 307 
building 
CMS nucleus 49, 151, 247 
CP nucleus 61, 163, 258 


CMS load map 42, 53, 144, 156, 240, 252 


CP load map 65, 167, 261, 496 
creating 
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creating the CMSINST segment 103, 204, 301, 328 
creating the HELP segment 103, 204, 301, 328 


defining 

devices 17, 118 
formatting DASD volumes 113 
HCPSYS, HCPRIO 55, 158 


system generation (continued) 
image library 273 
installing 
image library 75, 176 
installing CMSDOS and CMSBAM 95, 196, 293 
installing CMSVSAM AND CMSSAMS $98, 199, 
296 
ITASK EXEC 25, 49, 61, 126, 151, 163, 222, 247, 
258 
loading . 
CP nucleus 68, 169, 267 
Device Support Facilities 13 
loading starter system 17 
product tape 31, 133, 229 
starter system 17, 118 
loading starter system 3 
MAINT 5 
preparing for 12 
product tape 25, 124, 126, 222 
restoring starter system to disk 
spooling console during 21, 123 
tailoring DMSNGP profile 46, 148, 244 
user directory 71, 172, 263 
VMFBLD EXEC 493 
system generation tools 
loading 127 
system identification 
system generation 59, 161 
system national language 
installing 311 
System Network Architecture 
See SNA (System Network Architecture) 
system nucleus 5, 49, 61, 68, 151, 163, 169, 247, 258, 
267 
system residence disk 
system generation 58, 161 
SYSTIME, HCPSYS macro instruction 
system generation 58, 161 
SYSUVOL, HCPSYS macro instruction 
system generation 59, 161 


T 
tailoring 
DMSNGP profile 
existing system installation procedure 244 
Starter System installation procedure (first 
level) 46 . 
Starter System installation procedure (second 
level) 148 
HCPBOX ASSEMBLE 
Starter System installation procedure (first 
level) 55, 158 
HCPRIO ASSEMBLE 
Starter System installation procedure (first 
level) 55, 158 
HCPSYS ASSEMBLE 
Starter System installation procedure (first 
level) 55, 158 


15, 115, 217 


tailoring (continued) 
product parameter file 
existing system installation procedure 257 
Starter System installation procedure (first 
level) 55, 158 
user directory 
Starter System installation procedure (first 
level) 71 
Starter System installation procedure (second 
level) 172 
tape control, VMFPLC2 24, 125, 221, 687 
tape devices 
defining with starter system 18, 119 
temporary load list 
description 383 
example of 383 
temporary product parameter file 
description 403 
examples 403 
terminal 
defining with starter system 19, 121 
Text Decks 
example of 375 
text decks, self-documenting 
description 375 
TEXT files reformatted by PRELOAD utility 622 
TEXT file, PRELOAD utility program 623 
text shells 
description 375 
example of 376 
TOD (time-of-day) clock 21, 122 
setting 20 


U 
UPDATE command 

description 631 

files used by 636 

messages 640 

multilevel update 637 
with auxiliary control file 638 

options 631 
CTL 632 
DISK 632 
INC 632 
NOCTL 632 
NOINC 632 
NOREP 631 
NOSEQ8 631 
NOSTK 632 
NOSTOR 633 
NOTERM 632 
PRINT 632 
REP 631 
SEQ8 631 
STK 632 
STOR 633 
TERM 632 
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UPDATE command (continued) 
preferred aux files 639 
single-level updates 636 
update control statements 633 

DELETE 635 

format 633 

INSERT 634 

REPLACE 635 

SEQUENCE 633 

* (comment) 636 
UPDLOG filetype, use with 632 
use of control files 362 

update control statements 633 

update files 
description 367 
example of 368 
guidelines 369 
naming conventions 366 
receiving 419, 424, 532 

update shells 
description 368 

updating 
HCPLDR 590 
macro libraries 665 
servicing the system 590, 631, 657, 661, 665, 702 
source files 631 
tailoring DMSNGP profile 46, 148, 244 
VMFHASM EXEC 631, 657 
VMFLKED 661 
VMFMAC 665 
VMFVIEW EXEC 702 

USER DIRECT 
See user directory 

user directory 
creating 26, 223 
DIRECTXA 583 
loading 25, 222 
sample 

for 3350 747 
for 3375 763 
for 3380 779 
for 3380-E4 793 
for 3380-K 807 
for 3390 823 
for 3391 837 
sample XAMAINT entry 
for 3350 756 
for 3375 772 
for 3380 788 
for 3380-E4 802 
for 3380-K 816 
for 3390 832 © 
for 3391 845 
system generation 4, 71, 172, 263 
updating 71, 263 
using DISKMAP EXEC to check changes 587 
user-owned DASD volumes 
system generation 59, 161 
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utilities 
CP 
regenerating 501 
UTILITY EXEC 
format 642 
functions 642 
messages 644 
options 643 


V 


VER control record 
example 717 
format 716 
function 716 
options 717 


special consideration during ZAP processing 719 


version identification 52, 154, 250, 323 
VMFAPPLY EXEC 645 

creating auxiliary control files 645 

exception log 380 

function 645 

return codes 651 
VMFBLD EXEC 652 

building the nucleus 652 

exception log 381 

function 652 

return codes 656 

system generation 442, 472 
VMFHASM EXEC 

command syntax 657 

control file 657 

function 658 

input and output files 659 

messages 660 

servicing the system 657 

UPDATE command 657 

using to update modules 657 
VMFLKED EXEC 

command procedure 661 

command syntax 661 

error messages 664 

format 661 

function 661 

how it works 661 

input files 662 

output files 663 

using to link-edit modules 661 

when to use 661 
VMFMAC EXEC 

command syntax 665 

control file 665 

function 665 

input and output files 666 

macro library 665 

messages 667 
VMFMERGE EXEC 

command options 668 


VMFMERGE EXEC (continued) 
command procedure 668 
error messages 670 
format 668 
how it works 669 
usage notes 670 
using to apply PTFs 668 
when to use 668 

VMFNLS EXEC 
command procedure 672 
command syntax 672 
format 672 
messages 676 
operands 672 
options 672 
when to use 672 

VMFOVER EXEC 677 
copying product parameter file 677 
function 677 

VMFPLC command 
command syntax 679 
format 681 

VMFPLCD command 
command syntax 681 

VMFPLC2 command 
command syntax 687 
loading tape files to disk 687 
system generation 24, 125, 221 

VMFREC EXEC 
exception log 379 
format 691 
restarting 383 
return codes 696 

VMFREC History File 
example of 381 

VMFREMOV EXEC 
command options 697 
command procedure 697 
format 697 
how it works 698 
messages 698 
using to remove PTFs 697 
when to use 697 

VMFSETUP EXEC 700 
function 700 

VMFVIEW EXEC 
command syntax 702 
servicing the system 702 
using to view exception logs 702 

VMFZAP EXEC 
format 707 
how it works 707 
messages 708 
using to apply ZAPs 707 
when to use 707 

VM/SP (Virtual Machine/System Product) 
installing VM/XA SP using 215 


VSAMGEN EXEC 

messages 101, 202, 299, 461, 479 
VSEVSAM EXEC 

command procedure 709 

command syntax 709 

format 709 

messages 710 

use, example 709 

when to use 709 


VSE/VSAM (Virtual Storage Extended/Virtual Storage 


Access Method) 
support using CMSBAM 624 


W 


work pack 
defining with starter system 18 
worksheet, starter system 7 


X 
XAMAINT virtual machine 
defining directory entry 216 
sample directory entry 
for 3350 756 
for 3375 772 
for 3380 788 
for 3380-E4 802 
for 3380-K 816 
for 3390 832 
for 3391 845 
XAPO01 volume 
allocating 27, 128, 224 
formatting 27, 128, 224 
XAP002 volume 
allocating 28, 129, 225 
formatting 28, 129, 225 
XASERV volume 
allocating 26, 128, 223 
formatting 26, 128, 223 
XEDIT (System Product Editor) 
providing support on local terminals 117 


Z 
ZAP command 
command procedure 712 
description 712 
format 712 
input control records 712, 713 
BASE 716 
COMMENT 719 
DUMP 713 
END 719 
function 713 
LOG 718 
NAME 715 
REP 717 
VER or VERIFY 716 
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ZAP command (continued) 
option output 713 
options 712 
when to use 712 

ZAPTEXT EXEC 
format 720 
input control records 720 
options 720 
procedure 720 
use of EXPAND command 721 
when to use 720 


Numerics 
1403 printer 
image library 
installing default 75, 176, 273 
3203 printer 
image library 
installing default 75, 176, 273 
3211 printer 
image library 
installing default 75, 176, 273 
3262 printer 
image library 
installing default 75, 176, 273 
3350 DASD 
minidisk maps 759 
sample HCPSYS ASSEMBLE 745 
sample user directory 747 
system residence DASD allocation 758 
3375 DASD 
minidisk maps 775 
sample HCPSYS ASSEMBLE 761 
sample user directory 763 
system residence DASD allocation 774 
3380 DASD | 
minidisk maps 791 
sample HCPSYS ASSEMBLE 777 
sample user directory 779 
system residence DASD allocation 790 
3380-E4 DASD 
minidisk maps 805 
sample user directory 793 
system residence DASD allocation 804 
3380-K DASD 
minidisk maps 819 
sample user directory 807 
system residence DASD allocation 818 
3390 DASD 
minidisk maps 835 
sample HCPSYS ASSEMBLE 821 
sample user directory 823 
system residence DASD allocation 834 
3391 
sample user directory 837 
3391 DASD 
minidisk maps 848 
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3391 DASD (continued) 
system residence DASD allocation 847 
3800 printer 
image library 
installing default 75, 176, 273 
4245 printer 
image library 
installing default 75, 176, 273 
4248 printer 
image library 
installing default 75, 176, 273 


Special Characters 


./ D (DELETE) UPDATE control statement 635 

./ I(INSERT) UPDATE control statement 634 

./ R (REPLACE) UPDATE control statement 635 
./ S (SEQUENCE) UPDATE control statement 633 
./ * (comments) UPDATE control statement 636 


SVMFAPP SERRLOG 380 
$VMFBLD SERRLOG 381 
SVMFREC SERRLOG 379 
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